For the new system to work, one of the biggest tasks in front of us is to recruit maintainers for all the newly created guides. During the migration, we'll be adding new guides which still need maintainers here.

If you'd like to help out and maintain part of the documentation (especially if you are a subject-matter expert), leave a comment and mention which part of the documentation you are interested in.

Instructions: how to write and maintain documentation, first steps as a maintainer.

For questions and chat with other maintainers: IRC #drupal-docs on Freenode, Slack #documentation on Drupal Slack.

Guides that need maintainers:

Drupal 7:

Drupal 8:

A lot of content for Drupal 8 hasn't been written yet. The work to identify which D7 guides need to be ported to D8 and porting them happens at #2774809: Write documentation for Drupal 8

Developer guide:

(these are version independent guides under https://www.drupal.org/docs/develop)

Comments

tvn created an issue. See original summary.

tvn’s picture

Issue summary: View changes

Adding some notes. As we are about to start migration, one of the biggest tasks will be to find maintainers for all the new guides.

tvn’s picture

joachim’s picture

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.

tvn’s picture

Perfect, thanks joachim. I'll ping you once we migrate any of those type of docs.

naveenvalecha’s picture

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

tvn’s picture

Issue summary: View changes

I started adding newly created guides that need maintainers, the first one is Understanding Drupal D7 and D8.

Please comment here if you'd like to maintain any of the two.

tvn’s picture

Issue summary: View changes

One more - Choosing Drupal version.

tvn’s picture

Project: Drupal.org customizations » Documentation
Version: 7.x-3.x-dev »
Component: Miscellaneous » Docs infrastructure
Category: Feature request » Plan

Moving to Documentation project.

tvn’s picture

tvn’s picture

Title: Governance for 'Documentation' section » Recruiting guide maintainers for documentaton
Issue summary: View changes
tvn’s picture

Issue summary: View changes

Adding Systems requirements guides.

Christopher James Francis Rodgers’s picture

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

joshmiller’s picture

Issue summary: View changes
Sam Moore’s picture

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 :-)

tvn’s picture

Issue summary: View changes

Removing D8 Understanding Drupal as Josh took it.

tvn’s picture

Thanks Sam! We are rolling out the new documentation system with the new concept of 'maintainers' for the first time right now, so literally every maintainer will be a novice at the moment :) I added you as a maintainer for the D7 Understanding Drupal guide.

Here are some instructions and info about the new documentation system in general: https://www.drupal.org/drupalorg/docs/content/documentation
Specifically first steps as a maintainer will tell you what to do https://www.drupal.org/drupalorg/docs/content/documentation#first-steps

Note also that joshmiller just signed up to work on the D8 version of the same guide over here: #2774765: Create Understanding Drupal guide for Drupal 8. You might want to coordinate a little in that issue. E.g. if there is any D8 content in D7 guide, he will need to move it into D8 guide first before it can be deleted from D7, etc.

If you have any questions, you can find me in IRC (#drupal-docs on Freenode) or on Drupal Slack.

tvn’s picture

Issue summary: View changes

Removing D7 Understanding Drupal guide as well.

tvn’s picture

tvn’s picture

Issue summary: View changes
tvn’s picture

Re #13: I can't see the contents of the .info files you uploaded.

Looking at the example page: using system message classes is not a good idea, however I understand what you were trying to do with them. We have a todo item in our backlog to introduce a few different styles of 'call outs' on the new doc pages to enable authors to highlight important info or caution readers.

The 'table of contents' you are using there is great. WYSIWYG supports easy creation of those. There is an 'anchor' button to add anchor link to any text. To link to an anchor, you can click 'Link' button, under 'Link type' select 'Link to anchor in the text' and pick an anchor from a drop down.

Having too many 'back to contents at this point' links clutters the page. However having one at the bottom of a long page might be a good idea. We should make it automated for all pages instead of copying and pasting into a template though. Feel free to open an issue to suggest that in the http://drupal.org/project/issues/drupalorg queue.

Lastly, WYSIWYG does allow source code editing, there is a 'Switch to plain text editor' link below the body (or any other WYSIWYG) field. It is of course fine to modify html directly in the interest of speed/personal convenience. However, it is better not to create custom new layouts/navigation or use classes with styles created for other purposes than documentation. We should keep the pages consistent in layout/navigation/styles etc.

opdavies’s picture

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

sushilck’s picture

I want to join as a maintainer for documentation.

tvn’s picture

@opdavies How about System requirements for D7 and D8? :)

@sushilck Great! Is there any topic you know well and would like to maintain? Any of the guides listed in the issue summary look interesting?

maxicooper’s picture

I can help with Spanish translation if needed.

rsomaskandan’s picture

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
sonman’s picture

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

tomgrandy’s picture

Would be happy to help write documentation.

heykarthikwithu’s picture

Title: Recruiting guide maintainers for documentaton » Recruiting guide maintainers for documentation
SwapS’s picture

Would love to contribute as maintainer for below topics

Extending Drupal
Updating your Drupal site
Multisite Drupal
Migrating to Drupal

Thanks,
SwapS

beautifulmind’s picture

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

Regards.

tvn’s picture

Issue summary: View changes

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

sushilck’s picture

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

opdavies’s picture

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.

Jazzika’s picture

Administering Drupal 7 Site.
Thank you.

tvn’s picture

Issue summary: View changes

@opdavies done, here is an issue about that one #2779213: Write up System requirements guide for Drupal 8

@rsomaskandan add you as a maintainer for the D7 Installing Drupal

@SwapS add you as maintainer for the D7 Extending Drupal

@Jazzika added you as a maintainer for the Administering Drupal 7 site

tvn’s picture

Issue summary: View changes

@sushilck added you as a maintainer for D7 Migrating to Drupal

@sonman added you as a maintainer for D7 Setting up cron guide

@beautifulmind added you as a maintainer for D7 Configuring clean URLs guide

tvn’s picture

@tomgrandy Are you interested in writing D8 documentation perhaps? Any particular topic?

tvn’s picture

Added everyone who commented so far as maintainers to various guides. (Except for joachim and naveenvalecha, I don't yet have the guides you were interested in migrated, will add you as soon as they are ready).

Thanks all!!

I am adding one guide per person for now, since it does include some work to ensure a single guide is up-to-date and well-written. Once you are done updating your first guide, and if you are interested in more, feel free to comment and sign up for more.

tvn’s picture

Issue summary: View changes

Adding couple more guides.

tvn’s picture

Issue summary: View changes
beautifulmind’s picture

@tvn Thank you.

Regards.

DSquaredB’s picture

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

Ryan Weal’s picture

Is there a plan for a Drupal 8 "Migrating to Drupal" guide? I put together a bunch of stuff for trainings that I have done at camps, I may be able to contribute if there is a desire for this.

rsomaskandan’s picture

@tvn Thank you

Cameron Tod’s picture

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

mikeohara’s picture

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
boshtian’s picture

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.

mchar’s picture

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

pio.fernandes’s picture

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’s picture

Issue summary: View changes

@DSquaredB thanks! Added you as a maintainer for D7 and D8 Choosing Drupal version guides. The D8 one needs to be written, here is an issue about it #2774779: Create Choosing Drupal version guide for Drupal 8. Feel free to assign it to yourself.

@Ryan Weal Absolutely. Most of the guides for D7 do not exist for D8 and need to be written. I started a meta issue #2774809: Write documentation for Drupal 8, but had no time to open child issues for each guide to be ported to D8.

I created a new empty guide for you https://www.drupal.org/docs/8/migrating-to-drupal.

tvn’s picture

@Ryan Weal note that 'Migrating to Drupal' in this context means migrating from another system into Drupal, not from another Drupal version. There is a separate guide for that.

tvn’s picture

Issue summary: View changes

@Cameron Tod added you to both guides, thank you!

tvn’s picture

Issue summary: View changes

@mikeohara added you as a maintainer for 'Updating your Drupal site' as someone else took the other two. Note that I haven't migrated all of the pages into that guide yet. There are a couple of pages already migrated, but there will be more once I start migrating the Structure guide and other books.

mikeohara’s picture

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

tvn’s picture

Issue summary: View changes

@boshtian Yes, it is a separate guide now. https://www.drupal.org/documentation/install/multi-site is what needs to be migrated into the D7 Multisite guide and then ported to D8. I just wasn't sure if everything there needs to be migrated or if some of the pages are heavily out-of-date (especially the how-to pages). Can you look through them and let me know which ones I should or should not migrate into the new guide? I added you as a maintainer for D7 guide and D8 guide (https://www.drupal.org/docs/8/multisite-drupal).

tvn’s picture

Issue summary: View changes

@mchar Added you as a maintainer for Backing up and migrating a site. Thanks!

tvn’s picture

@pio.fernandes would be great if you could take care of Multilingual guide. It is not migrated yet though, I'll add you as soon as it is ready.

tvn’s picture

Issue summary: View changes
tvn’s picture

Issue summary: View changes
tvn’s picture

Issue summary: View changes

Adding D8 guides that need maintainers.

tvn’s picture

Issue summary: View changes

Adding couple more D7 guides.

tvn’s picture

Issue summary: View changes
minorscience’s picture

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

jcost’s picture

Issue summary: View changes

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.

naveenvalecha’s picture

@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

tvn’s picture

Issue summary: View changes

@minorscience sure. Added you as a maintainer. As with the other D8 guides, this one is currently empty. The first step would be to review D7 Installation guide and copy relevant info from there, or move if it is D8-specific.

@jcost Added you as a maintainer, thanks!

@naveen Thanks for noticing, fixed.

DWB Internet’s picture

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

tvn’s picture

Issue summary: View changes

@DWB Internet added you, thanks!

schiavone’s picture

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’s picture

Issue summary: View changes
tvn’s picture

Issue summary: View changes

@schiavone Added you as a maintainer for D7 'Site Building best practices'. Thank you!

tvn’s picture

Issue summary: View changes
schiavone’s picture

@tvn glad to help

tvn’s picture

Quick note to all those who signed up as maintainers - 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 when someone adds a suggestions via Discuss tab of the guide or any page inside of the guide. I already see people offering help in maintaining the guides or offering suggestions how to modify specific pages. (We have a todo to make sure maintainers follow their guides automatically when added).

If you are unsure where to start with your guide, here are some recommended first steps: https://www.drupal.org/drupalorg/docs/content/documentation#first-steps

For questions and chat with other maintainers you can join: IRC #drupal-docs on Freenode, Slack #documentation on Drupal Slack.

tvn’s picture

Issue summary: View changes

Adding more guides that need maintainers.

joaa’s picture

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

mchar’s picture

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!

pio.fernandes’s picture

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

agilman’s picture

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

solide-echt’s picture

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

boshtian’s picture

@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.

Cameron Tod’s picture

@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’s picture

Issue summary: View changes

@joaa added you as a maintainer for the 'Upgrade to Drupal 7' guide.

@mchar Thanks for your offer, I am currently trying to stick to one guide per person as it is quite some time commitment. Most of the guides still need reviews and edits as per https://www.drupal.org/drupalorg/docs/content/documentation#first-steps. Once the initial guides are cleaned up, I'll encourage people to help out with more than one guide.

@pio.fernandes added you as a maintainer for the Multilingual guides.

@agilman Added you as a maintainer for the 'Monitoring a site' guide. It is currently pretty empty, would need some content written.

tvn’s picture

Issue summary: View changes

@boshtian per your comment I migrated all of the pages into https://www.drupal.org/docs/7/multisite-drupal except for HowTos (still at https://www.drupal.org/node/43816).

@solide-echt Added you as a maintainer for 'Organizing content with taxonomies'. Hope that works, it used to be a part of the Structure guide.

joaa’s picture

@tvn Thanks for the opportunity

agilman’s picture

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

Ryan Weal’s picture

I have added my colleague italiatina as a co-maintainer of the Migrating to Drupal guide. Her and I are going to collaborate on adding the resources to that section.

tvn’s picture

Thanks @Ryan Weal. Make sure to remove 'Needs maintainers' status on your guide.

joachim’s picture

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.

tvn’s picture

@joachim It would be good if you could take Config management for now. Will add you in a moment.

tvn’s picture

Issue summary: View changes

Adding theming guides.

tvn’s picture

Issue summary: View changes
tvn’s picture

Issue summary: View changes

Adding more guides.

tvn’s picture

Issue summary: View changes

Adding more.

tvn’s picture

Issue summary: View changes
joachim’s picture

> 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?

eojthebrave’s picture

> 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.

joachim’s picture

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

tvn’s picture

Where will those show up in the dashboard?

Under 'your posts' with the rest of content you follow, such as issues, individual doc pages, case studies.

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.

Yes, indeed. This is still on our to-do list.

matthieuscarset’s picture

Hi,

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

Where am I supposed to sign up?

joachim’s picture

> 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.

tvn’s picture

Issue summary: View changes
tvn’s picture

@matthieuscarset There are a few theming guides available. For D7: Theming Drupal 7, Advanced theming, Overriding themable output, and for D8 Theming Drupal 8, Twig in Drupal 8. Just let me know in comments here which one is of interest to you.

tvn’s picture

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

I'll add an issue later today. Unfortunately that does not mean that our staff members will be able to work on this sooner. We are happy to provide dev sites if someone from the community is willing to take it on.

That's a fair point in #102. The main docs page is in a bit of a flux at the moment, while the migration is still going. I'll add clear links to D7 and D8 docs on top of it.

tvn’s picture

I created a number of issues today for various things we already had in mind. They all are child issues of #2533684: Create 'Documentation' Section and you can see them in the sidebar.

Specifically related to #102 I opened:
#2796609: Display the guide user maintains on their user profile and #2796615: Add 'Your guides' tab to the user profile

tvn’s picture

Issue summary: View changes

Added more guides that need maintainers.

ijf8090’s picture

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

Regards
Ian

joachim’s picture

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.

ijf8090’s picture

tvn’s picture

@ijf8090 Which guide would you like to maintain? There is a list of available ones in the issue summary.

eojthebrave’s picture

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?

tvn’s picture

Issue summary: View changes
ghazlewood’s picture

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
tvn’s picture

Issue summary: View changes

@ghazlewood Added you as a maintainer, thanks! I typically only add one guide per person for now, but 4 of the ones you listed are sub-guides of the 5th one - Theming D7, so I thought it'd be fine.

tvn’s picture

Issue summary: View changes
tvn’s picture

Issue summary: View changes
naveenvalecha’s picture

Ryan Weal’s picture

If anyone else is interested in Migrate docs I'm happy to turn it over to them. I had a great time at DrupalCon Dublin and realized I've been gradually shifting away from migrate, so I'm going to keep going down that path.

kaymccormick’s picture

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.

akishankar’s picture

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

  • Installing Drupal
  • Extending Drupal
  • Administering Drupal
eleanor_wai’s picture

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

tvn’s picture

Issue summary: View changes

@kaymccormick Any specific guide from the issue summary you are interested in?

@akishankar Are you interested in Drupal 7 or Drupal 8. 'Administering Drupal 8' (https://www.drupal.org/docs/8/administering-drupal-8-site) still needs maintainers.

@eleanor_wai Added you as a maintainer for 'Comments' guide. Thanks!

tvn’s picture

Issue summary: View changes

Removing guides that have maintainers already, the list is getting long.

tvn’s picture

Issue summary: View changes
joachim’s picture

> 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’s picture

Issue summary: View changes

Updating the list of D7 guides that still need maintainers.

tvn’s picture

Issue summary: View changes

Updating the list of D8 guides that need maintainers.

tvn’s picture

Issue summary: View changes

Adding Developer guide sub-guides that need maintainers.

tvn’s picture

Issue summary: View changes
akishankar’s picture

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

kaymccormick’s picture

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

tvn’s picture

Issue summary: View changes

@akishankar added you as a maintainer for Administer Drupal 8.

@kaymccormick Drupal 7 or 8? :)

kaymccormick’s picture

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

tvn’s picture

Issue summary: View changes

@kaymccormick added you!

Francewhoa’s picture

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

I have extensive experience with contributing documentation on drupal.org

tvn’s picture

Sorry for delay, Francewhoa. I added you as a maintainer for Development tools guide. The three pages about Eclipse you mentioned are inside of this guide, so this means you're maintainer for all of them. Thanks!

tvn’s picture

Issue summary: View changes

Adding more Drupal 7 guides that were migrated and need maintainers now.

tvn’s picture

Issue summary: View changes
tvn’s picture

Issue summary: View changes

Adding more Drupal 8 guides that need maintainers.

tvn’s picture

Issue summary: View changes
tvn’s picture

Issue summary: View changes
tvn’s picture

Issue summary: View changes
tvn’s picture

Issue summary: View changes
asherry’s picture

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.

tvn’s picture

Issue summary: View changes

@asherry, that's totally ok as long as you have time to take care of both. Your menu guide is already in a pretty good condition, thanks for cleaning all of that up! I added you as a maintainer for the JavaScript API.

mradcliffe’s picture

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.

tvn’s picture

Issue summary: View changes

Added you as a maintainer, mradcliffe. Thanks!

neerajsingh’s picture

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

tvn’s picture

Issue summary: View changes

Added you as a maintainer, neerajsingh. Thanks.

Here are some docs to help https://www.drupal.org/drupalorg/docs/content/documentation#first-steps

JDSaward’s picture

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

tvn’s picture

Issue summary: View changes

@JDSaward, done! Thanks.

jaesperanza’s picture

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!

tvn’s picture

Hi jaesperanza, added you as a co-maintainer for Managing users guide. Thanks.

jpoesen’s picture

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.

tvn’s picture

Issue summary: View changes

Hi jpoesen, added you as a maintainer for both guides. Thanks!

jpoesen’s picture

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.

tvn’s picture

You are correct. There were no docs for the D8 Database API. I created a new guide just now: https://www.drupal.org/docs/8/api/database-api. Feel free to create new pages inside and move your D8 content there ('Add content' block with links to do that is at the bottom of the sidebar).

jpoesen’s picture

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.

tvn’s picture

@jpoesen can you ping in on IRC or Slack when you're around?

Mohammed Nur’s picture

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

tvn’s picture

@Mohammed M Nur All the guides you listed already have maintainers. You could contact them directly and offer help. The guides that currently don't have any maintainer are listed in the issue summary.

Mohammed Nur’s picture

Hi @tvn,

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

Regards,

Mohammed

banoodle’s picture

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

tvn’s picture

Issue summary: View changes

@Mohammed M Nur, sure. Added you. Thanks!

@banoodle, added. Thanks!