Improve project descriptions by using a template suggestion for the body field

Feedback/comments/questions left in Google Doc

Added some comments in the doc

The Google Doc has outlasted its usable life; transcribing the most recent thoughts back to here in the issue. We can work here moving forward.

Here's the proposed template:
==========

Here, write an introduction that summarizes the purpose and function of this project with a focus on users brand new to Drupal. Answer the question: What solution does this module provide? The first 200 characters of this will be shown in the Project Browser "grid" view. You can also manually hit "edit summary" above and manually enter the exact summary you want.

<h3>Features</h3>
Here, answer the following questions: What is the basic functionality? What unique features does enabling this project add? When and why would someone use this module? What use cases are there?

<h3>Post-Installation</h3>
How does this module actually work once I install it? Should I go to a config page? Should I look for a new content type? Should I go and manage my input formats? Provide an overview of the configuration process and any other special considerations for the module.

<h3>Additional Requirements</h3>
Does this project need anything beyond Drupal core? Include any dependent modules, libraries, APIs, etc., that are required for this project to work.

<h3>Recommended modules/libraries</h3>
Are there any projects that enhance or improve the functionality of this project?

<h3>Similar projects</h3>
If there are modules providing similar functionality, please describe what differentiates them.

<h3>Supporting this Module</h3>
If you have a Patreon, OpenCollective, etc. you can put links here to describe how people can support development. 

You may continue to put additional information below here, if there are other things you think people need to know about your module!

==========

Talking with @gaurav.kapoor about this in Prague - one thing that would be awesome, he says (and I agree) is adding a section for "Community Resources" - just as an optional section where you can link to YouTube, blog posts, tutorials, etc. generated by the community. Why this is good:

1.) agencies would love to know they could be featured by producing quality content
2.) it takes some of the documentation burden off the maintainer
3.) but maintainer can still review & decide what to include
4.) shows the gaps in documentation for people to produce / provide new quality content

I think this looks really good, my comments below:

• For our needs with the project browser, I think we should give guidance about the summary being simple and written for a non-technical reader. Plus 1 for #9.
• Depending on the implementation of modified categories we may need to add notation to this.

The "Plan" category is used for meta issues

- https://www.drupal.org/docs/develop/issues/fields-and-other-parts-of-an-...

Here, write an introduction that summarizes the purpose and function of this project with a focus on users brand new to Drupal. Answer the question: What solution does this module provide? The first 200 characters of this will be shown in the Project Browser "grid" view. You can also manually hit "edit summary" above and manually enter the exact summary you want.

Features

Here, answer the following questions: What is the basic functionality? What unique features does enabling this project add? When and why would someone use this module? What use cases are there?

Post-Installation

How does this module actually work once I install it? Should I go to a config page? Should I look for a new content type? Should I go and manage my input formats? Provide an overview of the configuration process and any other special considerations for the module.

Additional Requirements

Does this project need anything beyond Drupal core? Include any dependent modules, libraries, APIs, etc., that are required for this project to work.

Recommended modules/libraries

Are there any projects that enhance or improve the functionality of this project?

Similar projects

If there are modules providing similar functionality, please describe what differentiates them.

Supporting this Module

If you have a Patreon, OpenCollective, etc. you can put links here to describe how people can support development.

Community Documentation

A great place to add links to YouTube walkthroughs, external documentation, or a demo site (use DrupalPod!).

You may continue to put additional information below here, if there are other things you think people need to know about your module!

Moving this over to the Drupal.org customizations queue as it's seen some review & additions and I think we can do this!

One small nit - “… and manage my input formats?” If I recall correctly, these are “text formats” in the Drupal admin UI.

The first 200 characters of this will be shown in the Project Browser.

We can align this with what is shown for project browsing on Drupal.org itself. That limit is currently 600 characters.

It looks like Drupal is counting characters, not bytes, so we don’t have to worry about 200 bytes not being a lot for multi-byte characters.

I added the proposed resolution to a branch and created the MR for it.

You can see it when creating brand new projects: https://fjgarlin-drupal.dev.devdrupal.org/node/add/project-module

This is now set on production. Thanks all!

Good call. I jumped straight into code forgetting about the default value via UI.