Project page Getting started steps are inadequate

Created on 22 December 2020, about 4 years ago
Updated 9 March 2023, almost 2 years ago

Problem/Motivation

Project page Getting started steps are inadequate

Steps to reproduce

Read the Getting Started steps.

Note that step #3 says:

Make sure your new layout section paragraph type is selected under “Reference Type” on the content type’s reference field edit screen by clicking “edit” for the respective field on the “Manage fields” tab.

But the prior step leaves the user on the Manage Fields screen for the Layout Section Paragraph that was just created. There is no prior mention of a "Content Type", nor is there any step that takes the user to the Manage fields screen for one.

Proposed resolution

Provide an intermediate step that gets the user to the proper screen so they can continue, or at least explain how the content type becomes involved.

🐛 Bug report
Status

Needs work

Version

2.0

Component

Documentation

Created by

🇺🇸United States jptillman

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Comments & Activities

Not all content is available!

It's likely this issue predates Contrib.social: some issue and comment data are missing.

  • 🇺🇸United States alison

    I agree with others that the "getting started" steps aren't quite complete -- gotta make sure the entity reference field on your content type allows several paragraph types to be selected.

    For others landing here, I found this tutorial helpful -- especially starting at minute 18:
    https://atendesigngroup.com/webinar/implementing-layout-paragraphs-how-i...

  • 🇺🇸United States Daniel Flaum

    Thanks for link to the video, alison. Unfortunately it didn't help. Since it's 480p I can't read anything on the presenter's screen. I know I didn't follow the steps correctly, but since I can't actually see what he did I don't know where I went wrong.

    This issue has been kicking around for two years and still hasn't been adequately addressed. It's really important, since without good instructions people can't actually use the module. If this were a big in the source code, it would be the kind that prevents the module from working at all.

    I'd love to contribute documentation--I'm good at writing it--but since I don't understand how to use the module myself, I can't write it. Is there anyone who has got this working who's willing to walk me through it via Zoom or something? Then I could contribute better documentation.

  • 🇺🇸United States alison

    @Daniel Flaum Ha! Good detective work, thank you for sharing back! Looking at the lower quality video again, I have no clue how I was able to understand it, somehow I managed, but I don't know how.

    Anyway, more importantly, how's it going after finding the higher quality video, did that help you get off the ground -- or too soon to tell? (I know these things go on and off our front-burners, maybe you haven't dug back into it yet.)

Production build 0.71.5 2024