Recruiting guide maintainers for documentation

I'd be happy to help with maintaining part of the documentation -- don't really mind which, but something more to do with module development or site building rather than theming.

I'm also happy to maintain the Module development guide pages

Quick Question:

How likely are my oft-used templates
that I am currently using at d.o
going to be viable at the new doc section?
(see two attached files)

A sample page using them:
https://www.drupal.org/node/2767991
Note that from the visitor's pov,
the template easily allows me to incorporate
on-page navigation in a one-column design,
with unlimited header-title length capabilities,
and full and exacting details fit for absolute beginners
or seasoned pros.

Your new docs section does not seem to allow source code editing,
and while WYSIWYG is fine as an option for beginners to HTML,
(who will never have the nerve to post at d.o anyway,
... please do not kid yourself ...maybe one in ten-thousand)
WYSIWYG-only is a huge hindrance to productive d.o doc creation.

I welcome (even beg) for you opinions.

Thank you ever so kindly for you time, help, and attention.

-cjfr

I'd be happy to help maintain Understanding Drupal for D7, or anything around site-building or theming.
However I will certainly need some guidance as to what to do and how to do it...
If I can be of service as a novice maintainer, I'm yours. If not, just say so :-)

I'd be happy to maintain any of the following:

* System requirements
* Setting up cron
* Extending Drupal
* Multisite Drupal
* Backing up and migrating a site

I want to join as a maintainer for documentation.

I can help with Spanish translation if needed.

As a novice maintainer, I would be happy to contribute my best in the following:

• Installing Drupal 7
• Extending Drupal
• Updating your Drupal site
• Administering Drupal 7 site
• Backing up and migrating a site

I am new to maintaining but I will be happy to help maintain any of the Drupal 7 guides.

Would be happy to help write documentation.

Would love to contribute as maintainer for below topics

Extending Drupal
Updating your Drupal site
Multisite Drupal
Migrating to Drupal

Thanks,
SwapS

Hello,
I would be happy to handle any responsibility mentioned above.
Please count me in.

Regards.

Please add me for below documents-

Drupal 7:

Updating your Drupal site
Multisite Drupal
Migrating to Drupal
Administering Drupal 7 site
Backing up and migrating a site

Drupal 8:

Choosing Drupal version
System Requirements

added you as a guide maintainer for D7 System requirements, let me know if you're also happy to take D8.

@tvn Yes, happy to take D8 too.

Administering Drupal 7 Site.
Thank you.

@tvn Thank you.

Regards.

I can help with the guides for site building, choosing versions, etc., for D7 or D8 if you still need maintainers.

@tvn Thank you

I'd like to take the performance and caching sections of D7, it help is still needed.

I'd love to be a maintainer for:

Drupal 7:

• Choosing Drupal version
• Updating your Drupal site

Drupal 8:

• Choosing Drupal version - needs to be written

Is 'Multisite Drupal' about the structure of sites folder and settings about it?

Because it can be found here: https://www.drupal.org/documentation/install/multi-site, but it's under /install at the moment, where the migrated guide https://www.drupal.org/docs/7/installing-drupal-7 doesn't have this information.

If this is a separate guide now, I can assign to be a maintainer for Drupal 7 and also the Drupal 8 version of this documentation.

I'd like to help with the Drupal 7: "Backing up and migrating a site", "Managing site performance" or "Caching to improve performance"

Hi @tvn I'd like to apply to maintain any type of documentation, but I am very inclined for the performance documentation and multi-language topics.

@tvn: Great! thanks! Thank you for the opportunity.

New guides look great and read very well! Happy to contribute a Drupal 8 installation guide if it's still needed.

Hi Tatiana!

I'd be willing to take on Managing Users. I'll keep my eye open for others that may not be as technical.

@jcost,
Did you update the summary for some reason or it accidentally updated ? https://www.drupal.org/node/2682083/revisions/view/9979061/9979347
cc / @tvn

If you're still looking for maintainers for the D7/Accessibility guide, I'd be glad to help out.

I'd be happy to help with the guides. I can help with most areas. Out of those that need a maintainer my preference would be...

Drupal 7:

Site Building best practices (I've presented at camps on this topic)

Drupal 8:
Configuration management

But i can help someone else out as well.

Daniel

@tvn glad to help

Hi @tvn,

Will be glad to be maintainer for the Upgrade to Drupal 7 documentation, also (when available), converting D7 module to D8 module documentation.

regards

I am already a maintainer for the "Backing up and migrating a site" (D7) and unless nobody would appear for the "Nodes, content types and fields" I can take it as well, thanks!

Hi @tvn
You added Nodes, content types and fields & Organizing content with taxonomies, so I am happy to volunteer on those, plus Multilingual migration. I wonder the best way to help with migration of Multilingual documentation, also.
Best,
Pio

I'd be thrilled to work on any of these:

Upgrade to Drupal 7
Monitoring a site
Nodes, content types and fields
Organizing content with taxonomies

I'm happy to contribute with documentation, preferably for Structure Guide subjects.

@tvn Sorry for the late response on Multisite Drupal documentation. I checked the old one, and I agree that how-to section is outdated (some of the articles dated in 2007 and for Drupal 5). I would also rewrite other documentation a little bit, to make it clearer. For example Multi-site on Linux has three subpages which I would combine in one Documentation page with anchors.

So if you want you can migrate all the pages except the howto's and I'll rearrange them from there. But maybe it would be even better if I just copy-paste all of them and do the merge and reorganization while doing this. What do you think?

You can find me on Slack or IRC for further discussion.

@boshtian I wrote a couple of articles on Acquia.com which you are welcome to plagiarise/reference/ignore: https://dev.acquia.com/blog/power-drupal-multi-site-part-1-code-management

@tvn Thanks for the opportunity

@tvn - thank you, as well, for the opportunity! Looking forward to contributing!

I'm happy to take Configuration management if needed, but I'd also like to maintain one of the more developer-orientated guides once they're ready.

> make sure you follow your guides ('Follow' link in the sidebar on the guide page) - this way you will get an email and/or dashboard notifications

Where will those show up in the dashboard?

Also, is there somewhere a list of the documentation sections a user maintains? Should this maybe appear on a user's account page?

> Also, is there somewhere a list of the documentation sections a user maintains? Should this maybe appear on a user's account page?

I don't think this happens currently, but it's one of the things we've talked about being a cool feature to have in the future. Much like we list modules that someone maintains. This makes it both easy for someone to find the guides they maintain, but also allows others in the community to give karma/credit to people who are putting in the effort to help maintain a guide.

Is there an issue for that in the d.org customizations queue?

Hi,

I'd be happy to help maintaining the doc about Theming or Module development.

Where am I supposed to sign up?

> Also, is there somewhere a list of the documentation sections a user maintains? Should this maybe appear on a user's account page?

Could someone make an issue in the d.org customizations project for this, so it can be worked on?

I would say it's a high priority.

Currently, the only way I can get to the guide I am maintaining is by finding the email from tvn that told me I was the maintainer...

This morning I had a little free time to work on it, and thought I could just navigate to my section. I went to https://www.drupal.org/documentation, but all the links there are to D7 guides -- the 'understanding Drupal' link goes to https://www.drupal.org/docs/7/understanding-drupal for instance. I can't actually see how to get to the D8 guides from the main docs page.

If you have need of a novice maintainer I would be interested in helping.

Regards
Ian

I just saw a Drupal Planet post about https://www.drupal.org/project/user_guide, which says it's going to be on d.org soon. How does that compare with the guides here? It seems to me looking at the TOC of that project that there's an overlap.

I just saw a Drupal Planet post about https://www.drupal.org/project/user_guide, which says it's going to be on d.org soon. How does that compare with the guides here? It seems to me looking at the TOC of that project that there's an overlap.

Yeah, there's overlap in content for sure. But I don't think there's a ton of it. Not yet anyway. It looks like most of the Drupal 8 guides here related to site building and basic pointy clicky things are still pretty bare.

My personal hope is that once the User Guide has been added to Drupal.org and is browesable and can be linked to like the rest of the documentation is that it will be highlighted as sort of an introduction. "New to Drupal? Start here!".

The intent is for the User Guide to cover only as much as is necessary to complete the task being defined in the guide, and then to link to existing documentation where available for further reading on any particular topic. For example, the user guide might walk through an explanation of the basic use-case for views, and then demonstrate building a view that can be used to replace the front page as concisely as possible. Then link off to other existing documentation for anyone that wants to take their views knowledge further and also build an RSS feed, or whatever the case may be. The User Guide will walk through step by step instructions, but it will never have the in-depth detail that a dedicated "Views Guide" could provide.

The guides that we're creating here, like the "Configuration Management" guide, could point to the User Guide for Drupal basics, and high level-conceptual knowledge. Perhaps we could even get to a point where the documentation in the Configuration Management guide can make the assumption that people have either already read, or at least are familiar with, everything that's introduced in the User Guide and can therefore stay focused on the CMI specifics and not have to get into the weeds of basic Drupal administration skills.

That said, it's all conjecture until we actually get the User Guide published and start figuring out how to best fit it in with other content.

On the difference between these new documentation guides, and the user guide project. The User Guide was created using a bit of a different editorial process. It is another attempt at solving a lot of the same issues that we're trying to solve here with guides and maintainers. Editorial review, curated lists of topics to cover, and being able to reign in scope a little so we can also define what we're NOT going to cover. But, in this particular case we wanted to be even more strict.

For example, with these documentation guides one of the problems we wanted to solve was having peer review of documentation. As a guide maintainer you can get alerted every time someone changes a page in your guide. You can then go and review those edits to ensure consistency and accuracy. This allows for the possibility of review without also taking away the free-form wiki style nature of Drupal's community documentation. The user guide uses a patch based workflow, with patches having to be reviewed and signed off before they are added. So the barrier to entry for editing might be a little higher.

With the user guide we created the entire book outline, and then did some basic user testing with it, before setting out to write it. So we knew for sure what the guide would and would not contain.

For these guides, it's up to the individual guide maintainers to do what they can/will to help improve their own section. And to some extent to decide what that means for their section. I would encourage you to review the content that others are posting in your section to ensure it is accurate, etc. But there's no requirement that you do so. I would also encourage you to create an outline for your section that identifies not only content that's already been written, but also what's missing. And then either write, or recruit others to help write, the missing content. Again, not required.

This whole having maintainers for sections of documentation thing is still new. We now have the technical ability to do so, the next step will be figuring out what the expectations are doing so are.

Does that help to clarify things at all? Suggestions? Thoughts?

I'd be happy to look after the following sections:

• Theming Drupal 7
• Advanced theming
• Overriding themable output
• Theming Tools and Best practices
• Theming HowTos

Adding related issue #2802095: Need new guide for Managing site performance and scalability under Drupal 8 documentation

I'm happy to maintain a section, or topic, or however it works. I Am currently getting up to speed, so the area where I would have most to contribute is related to developer on-boarding. I will try to keep this in mind and contribute.

@tvn, I would be happy to contribute the best of my knowledge for the below mentioned sections:

• Installing Drupal
• Extending Drupal
• Administering Drupal

I would like this opportunity to learn and work more on Drupal 7. I would like to help maintain these Drupal 7 documentations. It will be helpful for me to prepare to take Drupal certification exam. I hope you select me to me a maintainer.

Comments
Mobile guide
Working with blocks
Working with menus
Working with user profiles
Creating accessible themes
Working with CSS

> If anyone else is interested in Migrate docs I'm happy to turn it over to them

I would be interested in this, but:

a) while I have a lot of experience with Migrate on D7 (and contributed to the docs), I've not yet used it on D8.
b) I already have one documentation section I maintain. I would say that that I've done the necessary clean-up and copyediting and so I now consider it to be fairly static and not requiring more work for now.

@tvn, I am fine with Drupal 7 as well as Drupal 8

tvn: Creating custom modules, that is the area I am focused on.

Drupal 8 - didn't see that both 7 and 8 needed maintainers for this.

Hi all documentation enthusiasts :) I'm interested to contribute as maintainer for the following

• ERPAL (not yet migrated into the new system)
• ERPAL for Service Providers (not yet migrated into the new system)
• Features
• Development tools
• Configuring Eclipse
• Eclipse
• Drupal modules for Eclipse

I have extensive experience with contributing documentation on drupal.org

I'd like to be a maintainer of the Javascript API, it's one of the things I love the most about d7 actually. I don't know if that's ok given I'm already maintaining the menu section.

I think I can maintain the Typed Data API. I hesitated to remove the TBDs because I hadn't organized those in the first place and had not gotten any reviews on the docs that I wrote up before release.

I think I can maintain - Creating custom modules(Drupal 7).

I am wanting to learn. Please sign me up as maintainer for Drupal 7 - Working with blocks.

Hi!

I would be privileged to join as a maintainer for documentation. I can help out in any of the following:

Administering Drupal 7 site
Nodes, content types and fields
Managing users

Thanks and cheers!

Hi

I'd like to help tackle the D7 Database API and/or D7 dynamic queries (which is a subsection of D7 DB api).

Joeri.

Thanks @tvn.

I'm seeing D8-related content in the D7 Database API sections.
As per the documentation guide I'd remove that content, but I'm not seeing a D8 database API section at all. Am I missing something?

Thanks.
J.

Hi @tvn. I tried to create content in the D8 api section but the select list of parent menu items is empty so I can't continue there.

I guess it's a permissions issue and I need to be D8 DB api maintainer?
If so I can do that as well - it looks like the D7 and D8 DB api are fairly similar.

BTW if there's a more appropriate place to discuss these things, let me know.

Thanks.
J.

Hi @tvn

I would appreciate it if you can make me a maintainer for any of the following documentation:

Drupal 7 Taxonomy
Administering Drupal 7
Nodes, content types and fields
Managing users

Or any topic area as long as it's not module development or coding related.

Best regards,

Mohammed M Nur

Hi @tvn,

'Working with CSS' in D7 doesn't have a maintainer. Can I maintain this guide?

Regards,

Mohammed

I'd like to maintain Form API documentation (D7) if there is still a need.

I wrote https://www.drupal.org/docs/develop/standards/css/csscomb-settings-for-d.... Can you make me the maintainer of that page? Thanks.

Came here from #2762837. I'd like to help migrate/maintain the Zurb Foundation guide.

-

^^ #169 Sorry that was my comment logged in with the wrong user ;).

What I wanted to say:

It seems like https://www.drupal.org/docs/8/distributions doesn't have a maintainer.

If that's the case I wouldn't mind stepping up and maintain this :)

I'd like to contribute - HowTos (are minihowtos still a thing?)
Let me know where I can contribute.

Thanks!
Marcia

@tvn,
I would like to contribute to the following Guides.

1. Drupal 8 - Administering Drupal 8 site(https://www.drupal.org/docs/8/administering-drupal-8-site)
2. Drupal 7 - Monitoring a site (https://www.drupal.org/docs/7/monitoring-a-site)

Just signed myself up for D7 writing secure code

Just a heads up. You can now claim maintainership of any guide that is currently un-maintained without having to get someone else to assign you. Look for the "Become a maintainer immediately" link above the form you can submit to request being a maintainer.

See: #2875891: Create a faster path to becoming a maintainer for un-maintained documentation guides

I'd be happy to help maintain Understanding Drupal for D7, or anything around site-building or theming.
However, I will certainly need some guidance as to what to do and how to do it...

This may be irrelevant, but I saw many users, editing the documentation pages for just for some formatting just to get a credit on their profile page. Is there a way to stop this?

Hi,

I just found this thread.

As I wrote in #2915281: Volunteering to maintain 'Upgrade to Drupal 8' guide, I'm willing to maintain the Upgrade to Drupal 8 guide.

Cheers,
Markus

Hi all documentation enthusiasts :) I'm interested to contribute as maintainer for the following guides and all their sub-pages

• Updating a Drupal 7 site
• Updating a Drupal 8 site
• Distributions (D7)
• Distributions (D8)
• Testing (D7)
• Testing (D8)

I have extensive experience with contributing documentation on drupal.org

Hi,

I am interested in providing documentation especially architectural and component representation of a section. I can work on any section that requires such diagrams that would help readers. Currently, I am working on Testing(D8) guide.

Some of these diagrams are generated using PhpStorm and some of them are created using Google Drawing and maintained at Drupaldocs.

You can see some of my diagrams at Types of testing in Drupal 8, JavaScript testing and Browser testing pages.

Thanks to Tim Plunkett, I was just added to be a maintainer for accessibility in Drupal 8. :)
I would also like to be added to the maintainer list for D8 Mobile guide, if that group still needs help.

I am interested in helping maintain "Documenting your project".
I am already active in helping module maintainers with READMEs.

I 'd also be happy to help maintain the "Documenting your project". Part of my job is to fix coding standards and documentation in modules used in our projects. I reference the "Documenting your project" pages frequently.

@volkswagenchick, and @Daniel_Rose, I added both of you as maintainers to the Documenting your project guide. It already has a maintainer, but was flagged as seeking additional. Let me know if you've got any questions or if there's anything I can do to help you get started.

@cehfisher - I added you to the D8 Mobile guide https://www.drupal.org/docs/8/mobile

And, @vijaycs85 I've added you to the testing guide - https://www.drupal.org/docs/8/testing

For future reference, any guide that already has a maintainer you can you ping them, and they should be able to add you. If for someone reason you don't get a response you'll have to ask someone with permission. You can post here, in the docs issue queue, or probably webmaster issue queue as well.

Any guide that does not have any existing maintainers you should be able to claim ownership of by following the link in the sidebar on that guide page.

Thanks for stepping up to help out.

Please add me as a maintainer of https://www.drupal.org/docs/8/modules/json-api :)

I am a module maintainer and original author for most of the pages there. Thank you!

Can I become a maintainer of the https://www.drupal.org/docs/8/testing document please? I would like to consolidate the https://www.drupal.org/docs/8/phpunit document, so we have only 1 location for Drupal 8 Unit Testing. Thank you :)

@tmarshall@acromediainc.com I've added you as a maintainer to docs/8/testing. The guide already has 2 maintainers so it would be good to at least try and check in with them. Thanks for taking this on!

Hi there,
I have read all these comments here from all these nice people. I don't know whether I am eligible or not to ask that can I be a maintainer? If yes then please suggest me which of the part can be suitable for me as I am a newbie but much more confident with my work. If NO then please suggest me how can I be? TIA.
Thanking you all,
Partha Sarathi

I'd love to be added as a maintainer for the Charts module documentation: https://www.drupal.org/docs/8/modules/charts.

I maintain the Charts module, and being a maintainer of this documentation will help to avoid a lot of unnecessary issues being added to the Charts issue queue.

@eojthebrave, I did reach out to the current maintainer, but no response.

Thanks!

Hi. Please add me as a Drupal 8 Migrate API maintainer.

Re #190: I've added you as a co-maintainer to the Migrate API documentation handbook! Welcome and thanks for offering help!

A couple of things:

1. If you use IRC, please join #drupal-migrate. We actively use this channel with other Migrate Subsystem mainatainers + other core maintainers.

2. About the structure of Migrate subsystem
A) API level documentation

B) Migrate API Handbook (I added you as maintainer now)

C) Upgrading to Drupal 8 handbook

3. List of current documentation issues:
Documentation issues for 2A are handled in core Migrate Subsystem issue queue and tagged as 'API documentation'. http://www.tinyurl.com/migrate-api-doc-issues

Documentation issues for 2B and 2C are also managed in core Migrate Subsystem issue queue. The issues are tagged as 'd.o documentation'. http://www.tinyurl.com/migrate-do-doc-issues

4. Before making any radical changes, let's discuss those in IRC or by opening a separate policy-issue. You can also reach me by email, markus dot sipila at iki dot fi

5. Again, warmly welcome and thanks for your help!

Cheers,
Markus
Member of the core migrate subsystem maintainer team

@skpartha my recommendation would be to browse the existing documentation and find a section/guide that you feel like you could contribute to. It's hard for me to make a recommendation without knowing more about what you're interested in and what your current skillset is. We're always looking for additional help to though so let me know what guide(s) you think you might be interested in.

@andileco I added you as a maintainer to the Charts module guide here https://www.drupal.org/docs/8/modules/charts. Let me know if you've got any questions. Thank you!

Thanks, @eojthebrave! I think I may also need to be added to this how-to guide in order to put items in the menu: https://www.drupal.org/docs/8/modules/charts/charts-howtos

After that, I should be all set! Thanks again!

@andileco done!

@eojthebrave Thanks for your suggestions and also sorry for replying so late! I was in a process for getting hired for a company! now it's all set. Well, back on track, as I am a noob and still learning drupal 8 and also started with drupal 8, I want to do contribute on drupal 8. Now another important thing is that so many things are getting updated in drupal 8 from drupal 7, I am willing to learn about https://www.drupal.org/docs/8/api/migrate-api/migrate-process-plugins
so that I can help myself and can get myself comfortable in drupal 8. So I humbled request is to you that to add me on this task.
I will be thankful to you.

Re: 195. Thanks for offering your help @skpartha!

The migrate process plugin guide is actually complete, there are no pending documentation tasks on that guide. It was incorrectly listed in the issue summary as 'this guide needs maintainers'. I have now updated the issue summary.

Cheers,
Markus
Member of the core migrate subsystem maintainer team

Hi,
I am interested in being a maintainer of documentation of anything which is advisable for a novice. Please suggest me some so I can move forward with it. But I reall am interested and look forward to work for whatever I am assigned to.
Thank you.

Reply #196. You are welcome @masipila
Thanks for giving me a quick update. I would like to be added on module development related task!
Any suggestion regarding to this will be appreciated. Thanking you all.

Re #198: Thanks for the continued interest in contributing to Drupal @skpartha! The community is the heart and soul of Drupal and there are tasks suitable for all!

I understood from your first message that you are relatively new to Drupal. If you are interested in fixing issues and contributing patches to Drupal core, one of the easiest way to get started would be to search the Drupal issue queue which are tagged as 'Novice'. These issues should be quite straight forward to fix. That way you can learn the process on how patches are reviewed and finally committed to the codebase. More information can be found from here: https://www.drupal.org/getting-involved-guide

Cheers,
Markus

Reply #199 You are most welcome @masipila Will try to find a specific interest so that it can be easier to contribute.

I would like to create/maintain the Layout Builder documentation for D8. The help page should exist at https://www.drupal.org/docs/8/core/modules/layout_builder but it hasn't been created yet.

I would like to collaborate in documentation for:

Drupal 7 and Drupal 8 as I have projects in both and I think that what I learn from these projects could be valuable
for the projects since I work in diverse corporation environments where the configurations are highly complex.

What I would like to do is to add very useful information to implement several modules pages in these different environments.

Please let me know if this is possible.

Thank you
German

A number of documentation sections have been adopted (yay!). I've updated the issue description to cross out those who have maintainers. A number of other sections have maintainers, but still have the "Needs maintainers" text. I assumed for those sections that the current maintainers are still seeking co-maintainers and so didn't cross those off the list.

Fixed formatting of strikethrough sections.

I was given access to become a maintainer of the Charts guidebook in comment #194 (above). Before I was given access, the Charts guidebook had been created from Drupal 7 documentation. I'd like to move all that documentation over to a Drupal 7 guidebook so that I can clean up the Drupal 8 documentation. How do I start a Drupal 7 guidebook for the Charts module? Or can you start it and add me on it? Thanks!

@andileco: I can help you, but just need to be 100% sure want you want:

• Move https://www.drupal.org/docs/8/modules/charts to https://www.drupal.org/docs/7/modules/charts (because the current content is for D7).
• Recreate https://www.drupal.org/docs/8/modules/charts (empty) with you as maintainer

Hi @hansfn, yes, that's correct. Some of the documentation has been updated for 8, such as one or two of the HowTos. If you can make me a maintainer of both, I can make sure each guidebook has the appropriate content. Thanks!

https://www.drupal.org/docs/8/modules/charts now exists (empty) and has you as the only maintainer. Let me know if you need help moving some D8 pages from the D7 guide.

NB! The (sub) pages of https://www.drupal.org/docs/7/modules/charts still has URL aliases pointing to https://www.drupal.org/docs/8/... There is no way to update the URL alias of these pages when moving a guide. You'll have to fix it manually by doing a dummy edit.

PS! I updated the project page so it links to both the D7 and D8 guide under "Documentation" in the right menu. As a side-effect the module is listed as a related project at the bottom of the guides.

@hansfn, that's perfect! I was just about to do that myself. I've already started populating and updating the documentation. I'll be sure to fix the URLs, too--thanks for letting me know.

Hi there,

We were hoping to create documentation for our project https://www.drupal.org/project/feeds_migrate (provides a user interface to build migrations).

I'm a maintainer but don't think I have permission to set up:

https://www.drupal.org/docs/8/modules/feeds_migrate

Are you able to help us get the documentation page up and running? Thanks

@jamesdixon if you navigate to https://www.drupal.org/docs/8/modules, in the side bar, there should be a link near the bottom to add a "Documentation guide". Does the link appear for you? That should let you create a new guide for your documentation. If for some reason that doesn't work let me know and I can try and help get it sorted out.

@eojthebrave: Thank you that worked!

Hi, everybody,

I recently started reorganizing some parts of the pretty much overwhelming Creating custom modules guide, for example bundling several pages into the Creating custom field types, widgets, and formatters sub-guide.

I also noticed there is a new and quite well-written page Event Systems Overview & How To Subscribe To and Dispatch Events.
However, as the guide's maintainer @kaymccormick doesn't seem to be actively maintaining the guide anymore and did not react to an email either, all of these changes, and possibly more, won't show up in on the guide's menu.

It would thereful be very helpful if the guide could at least be opened up for unconfirmed changes. Otherwise I'll be happy to step in as a co-maintainer, so documentation doesn't stall in this area.

Regards, Pancho

Hey @Pancho thanks for your willingness to contribute. It's really appreciated! I've gone ahead and added you as a maintainer to the Creating custom modules guide. You should be able to add things to the menu etc. now. If you have any additional questions let me know.

Hi @eojthebrave i would like to help with the maintain the Routing system for Drupal 8.

@diosbelmezquia I've added you as a guide maintainer. Looks like https://www.drupal.org/u/pancho is also already a maintainer so might be worth reaching out to them in Slack (etc.) to coordinate efforts. Let me know if you have any questions. And, most importantly. Thanks!

Hi @eojthebrave thank!, i will reach out to @pancho by slack and we keep looking this topic as soon we can.

Yay! Feel free to just go ahead. I’m in favor of a more open, Wikipedia-style contribution process anyway.

Hi @Pancho i wrote you by Slack for we keep in touch anyway.

Hi @vijaycs85, @TylerMarshall, @Francewhoa

I would like to contribute the testing documentation from our deGov installation profile (https://www.drupal.org/docs/8/distributions/degov) to the general testing guide. Would you please add me as testing documentation guide maintainer (https://www.drupal.org/docs/8/testing)?

In #3137268: Add benjifisher as a sub-system maintainer for migrate I was added as a co-maintainer of the migration subsystem. I would like to be added as a maintainer of the related guide, Migrate API. It is marked as "This guide needs co-maintainers."

I have already made several edits to existing pages, including a new section on List of core Migrate process plugins. Today, I started a new page, Process Pipelines, but it has not yet been added to the menu of the guide.

I am already a co-maintainer of another guide, Installing Drupal (originally "Installing Drupal 8"). Although I have not updated it recently, I did put a lot of effort into the current organization of this guide. (It was just a stub when I started.)

@benjifisher, I added you as a maintainer to both Migrate API and Upgrading Drupal. So cool that folks from the current Migrate subsystem maintainer team can continue maintaining the docs.

https://www.drupal.org/docs/drupal-apis/migrate-api
https://www.drupal.org/docs/upgrading-drupal

Cheers,
Markus

@masipila:

Thank you! And thanks for all your work on the Migrate API docs.

I agree: the current maintainers should have responsibility for maintaining the documentation.

I realize now that the Migrate API guide has at least three sub-guides. Can you add me as a maintainer of those? Or can I do that myself, now that I am a maintainer of the parent guide?

@benjifisher, I added you as a maintainer for the three subguides that I was a maintainer for. There is actually fourth, https://www.drupal.org/docs/drupal-apis/migrate-api/migrate-field-plugins, which has been created quite recently in August. I'm not sure if that should be a guide or just a normal page, currently there is just one page in it...

Anyway, I can't add you as a maintainer for the Migrate Field Plugins guide because I'm not the maintainer of it. You should probably reach out to @DamienMcKenna so that he could add you as the maintainer. Unless @eojthebrave can add you directly.

Markus

@masipila:

Thanks again. I will check with @DamienMcKenna whether that should be a separate guide or just a page.

I am here out of frustration, which is sometimes the best motivator for volunteering. I am in need of GOOD documentation for all versions of Drupal, 7, 8, and especially 9. The biggest thing I think we need is clear navigation to documentation that is specific to those versions, such as 'drupal.org/docs/9" etc. How can I help, because Googling and Stackoverflowing for the answers isn't working for me.
User experience is a passion of mine, and as a user of Drupal my experience has not been the best, so I am here to see if I can help. What can I do?

@jweakley:

There is some related discussion on #2975147: Refactor Information Architecture of Documentation section.

You might get more responses if you post on the #documentation channel in Drupal Slack.

See also the Documentation and Help Initiative.

I am now a core mentor and would like to help maintain the guides.

Could I be made a maintainer for the following guides:
https://www.drupal.org/community/contributor-guide/reference-information
https://www.drupal.org/community/contributor-guide

Thank you

Hi @volkswagenchick I was able to add you as a maintainer of this guide https://www.drupal.org/community/contributor-guide/reference-information.

This one https://www.drupal.org/community/contributor-guide however isn't a standard "guide" content type page so I don't have permission to add you as a maintainer. Or to even edit that page. 🤷‍♂️ My recommendation would be to ask someone at the DA for permission to edit the page. Or to open an issue in this queue https://www.drupal.org/project/issues/drupal_org_community and go from there. Sorry I can't be of more help with that one at the moment. :/

Thanks Joe, I appreciate you.

I will reach out to the DA about the other guide, thank you for the link to tissue queue.

tissue queue

I cant tell if that's a typo or a joke, but either way I am into it.

I would like to help with the Form API documentation. I've just created a new page with a Form API workflow illustration created for a session for DrupalCon Prage (see https://events.drupal.org/prague2022/sessions/form-api-workflow).

I think the current Form API docs needs improvements, and I hope I will be able to propose changes that will help understanding this Drupal subsystem.

UPDATE: I'm already a guide maintainer!

I would like to help with the D7 EoL Soft Landing initiative: https://www.drupal.org/community-initiatives/drupal-7-soft-landing-initi....

@klonos I added you as maintainer of that documentation guide.

I want to help with "Automated testing" and "PHPUnit in Drupal".

I see the Drupal 7 Soft Landing Initiative is looking for more co-maintainers. I would love to help with this effort. 💙

Hi @cedewey, I've added you as a maintainer to that documentation guide. Let me know if you've got any other questions about editing the pages. And if you've got questions about the existing content reach out the other listed maintainers.

Having just written and uploaded Installing Drupal in DDEV in WSL2 on Windows, I would be happy to be a maintainer of Windows development environment (of which it is a part).

@Nick Hope: I have just added you (and I) as maintainers of Windows development environment.

I recently did the WSL, DDEV, Drupal exercise and it's not straight forward. I'll read the pages and see if I can contribute. And we probably need to discuss if some of it is DDEV related and not specific for Windows - don't know, haven't read it yet.

Hello, I added Drupal 10 CKEditor 5 replacement page for Media library.

Happy to maintain /core-modules-and-themes/core-modules/media-library-module/ or whole /core-modules-and-themes guide.

Isn't it time to remove the Drupal 7 references in the issue summary. And the Drupal 8 list is out of date, some of those guides have maintainers now.

As I'm Form API guide maintainer I'm removing it from the list that need maintainer.

Moved D7 down and will review existing guides.

I would be happy to be a maintainer of https://www.drupal.org/docs/getting-started/installing-drupal. Specifically, in the short-term, I would like to be able to move https://www.drupal.org/docs/getting-started/installing-drupal/before-a-d... to the first position in that guide (as explained on https://www.drupal.org/node/2799489/discuss).

I have added you, Nick. (And removed two inactive maintainers.)

I would like to offer to co-maintain the Managing site performance and scalability guide.

There are a few pages that needs to be reviewed and added to the menu.

• https://www.drupal.org/docs/administering-a-drupal-site/managing-site-pe...
• https://www.drupal.org/docs/administering-a-drupal-site/managing-site-pe...

Also, the order of Guides could be re-ordered.

PS. I sent a PM to @naveenvalecha earlier today, but later realized it looked like there was no activity by him since May 2025 ... so that's why I now post here.

I have been added, thanks @naveenvalecha :)