- Issue created by @joachim namyslo
- πΊπΈUnited States phenaproxima Massachusetts
@pameeela has more context, but if I remember correctly, the Help module was explicitly removed from Drupal CMS, as was the link to it in the navigation, for a good reason: the documentation provided by help is not helpfully organized -- it's segmented by module, not by task, and has no apparent consistent relationship to Drupal's actual administrative IA -- and tends to be technical in nature. In short, it just wasn't very helpful for the kind of people who would most benefit from strong documentation.
The Documentation track is working on much better documentation, and it won't live in Drupal itself (although where it will ultimately live is unclear). Once that track's output has a permanent online home, though, I am 1000% in favor of linking to it from within Drupal's navigation!
- π©πͺGermany joachim namyslo Kulmbach π©πͺ πͺπΊ
+1 for #2
Is there any initiative for that allready, where I can learn more about this?
- πΊπΈUnited States phenaproxima Massachusetts
Yes! There is a whole documentation track for Drupal CMS. It is being led by Amber Matz β and eojthebrave β . I would strongly suggest reaching out to them in Slack if you would like to help - I'm pretty sure they will welcome any assistance. :)
- πΊπΈUnited States eojthebrave Minneapolis, MN
There's an issue for the documentation track here π [META] Track 3: Drupal Starshot documentation Active . And technically Lenny is the track lead, though I've been helping out with the writing work. Right now, my (and Amber's) involvement is with the adopt-a-document initiative where we've helped develop an outline for a getting started with Drupal CMS guide, and the DA has been fundraising to pay for the creation of the content which Drupalize.Me is helping to produce. So it's kind of a weird slice of documentation and honestly I'm not sure how to go about including other people in the process. Though I do think that is something that would be good to figure out.
I know you've had experience with the Drupal User Guide, and I think this will end up being more akin to that than the wiki like documentation currently on Drupal.org. Happy to chat in Slack, feel free to ping me.
And, to the original issue. I totally agree that once there is content written that the Drupal CMS leads are happy with we should link to it from the Drupal CMS UI. It is sorely missing at the moment.
- πΊπΈUnited States phenaproxima Massachusetts
Let's postpone this until there is somewhere for a Help link to point to.
- πΊπΈUnited States phenaproxima Massachusetts
Note to self: when the help (which is written!) is available online (we're waiting on the DA for that), if we can link it in the navigation, we should. This is pretty critical and I will backport it to 1.0.x.