Title: Adding a Reference Field
Section: Setting Up Content Structure
File name: structure-adding-reference.txt
Covers: Add a content item reference field on Recipe called "Submitted By", which references a Vendor content item. The recipe content type is now ready to add content items, as a follow-on task.

Attribution

<<structure-image-style-create>>::
  Written by https://www.drupal.org/u/batigolix[Boris Doesborg]

Checklist for this phase

- Does it follow the template?
- Have the comments and placeholder text been removed from the template?
- Is everything the topic was supposed to cover included, and nothing extra?
- If there are @todo notes, are they clear?
- If there are images included, do they include instructions for how to redo them in a comment? (Note: Screenshots do not need to be perfect. Just make a rough cut.)
- Is attribution provided?

Support from Acquia helps fund testing for Drupal Acquia logo

Comments

jhodgdon created an issue. See original summary.

batigolix’s picture

Assigned: Unassigned » batigolix
batigolix’s picture

Status: Active » Needs review
FileSize
2.63 KB

first attempt

jhodgdon’s picture

Status: Needs review » Needs work

Looks good!

A few notes:

a) The comment at the top should be removed that says what the topic covers.

b) I think you're right about the index entries under Entity. Maybe also some that start with "Field"? But I'm not sure we need both "adding" and "creating" entries, since they'll be one right after the other in the index, maybe just things like:

Reference field, creating and adding

"Node reference field" might also be a useful entry for those coming from previous versions of Drupal, and "User reference field" too?

c) Start of Steps, first intro sentence, maybe start it with "Here are the steps to..." and end with : so it is not confused with being a "step" per se?

d) I can't think of any related or d.o references, so we can probably take out those @todo notes.

e) Needs screenshots

Anyway the text looks pretty good to me, just those minor comments... so probably ready for screenshots now! Thanks!

batigolix’s picture

I fixed the points mentioned in #4

Regarding point b): I also added Taxo term reference as index entry. And maybe adding&creating is a little bit too much of the same so I used "adding" according to the topic title.

Regarding d) do you know of any related concepts in the guide? If not you can remove the @todo

batigolix’s picture

Issue summary: View changes

Fixed the attribution

jhodgdon’s picture

Status: Needs review » Needs work

Oops, looks like you uploaded screen shots but not the .txt file?

batigolix’s picture

Status: Needs work » Needs review
FileSize
3.12 KB

oops and I deleted the site that contained the topics this morning ;)

but luckily there is the recycle bin ;) so find the txt attached

eojthebrave’s picture

Status: Needs review » Fixed

This looks good to me. I've gone ahead and added it to the guide. I made a small change to the provided attribution so that it references the correct topic.

Thanks Boris!

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.