Support for Drupal 7 is ending on 5 January 2025—it’s time to migrate to Drupal 10! Learn about the many benefits of Drupal 10 and find migration tools in our resource center.
Copy editing guideline for this issue
Every list should be preceded by either a header or a colon ( : ).
List items that are sentences end in period ( . ); list items that are not sentences do not end in period ( . ).
Task Instructions
- To claim this task, assign this issue to yourself (see instructions below). Only claim a task if you can complete it in about two weeks.
- See the instructions below to "clone" the guide, edit the entire user guide so that it follows the above copy editing guideline, and make a patch file. Do not make other edits at this time -- other edits will be taken care of in other issues. If you find that you cannot complete the whole task, but have made some progress, make a patch file for the part you've done.
- Upload the patch file to this issue, in the Files section.
- Set the Issue Status to Needs Review, in the Issue Metadata section.
- Write a comment stating what you've done.
- In this comment, add "Attribution" information
https://www.drupal.org/u/msmith[Mary Smith] or https://www.drupal.org/u/jsmith[Joe Smith] of https://example.com[Example Company]
- Someone will review your work, and either accept it, or set it back to Needs Work for more attention.
- If the status is set to Needs Work, make the requested changes, make a new patch file, and upload it. Iterate until it is fixed.
Detailed Instructions for Assigning Issues and Patching
Assigning an issue to yourself
- Scroll to the bottom of the issue to Add new comment.
- Open the "Issue metadata" section if it is collapsed.
- Put your user name in the "Assigned" field, add a short comment stating that you are claiming the task, and Save.
Editing and making a patch file
- In order to make a patch file, you will need to use the Git version control software. There are generic instructions on Git at: https://www.drupal.org/documentation/git/ -- if you have never used Git, you will probably want to read the introductory material, and you'll need to install Git.
- Specific Git instructions for the User Guide project can be found at https://www.drupal.org/project/user_guide/git-instructions . Follow the instructions to "clone" the repository (see the "One-time only" instructions).
- Make the edits for this issue, using a plain-text editor. The source files are located in the source/en subdirectory, and have extension .txt, and are in AsciiDoc format (see below).
- Go back to the specific Git instructions page and follow the instructions there to make a patch file. There are also more detailed git patch instructions in the Git documentation section linked above.
AsciiDoc formatting
The documentation in this project is formatted using AsciiDoc. The Formatting page in the User Guide guidelines (login: drupal / drupal ) has links and details for how to format text properly, make cross-links between topics, etc.
Comment | File | Size | Author |
---|---|---|---|
#4 | 2699069-4.patch | 5.7 KB | batigolix |
Comments
Comment #2
jhodgdonI've now centralized instructions for the editing tasks. I'll go ahead and leave the instructions on these issues, but you can also go to
https://userguide_new-drupal.dev.devdrupal.org/guidelines/instructions.h...
(log in with drupal / drupal)
and follow the instructions there (probably more complete).
Comment #3
batigolixgiving it a shot
Comment #4
batigolixMaybe I'm overllloking stuff but I didnt find a lot of issues with item lists.
See the patch
Comment #6
jhodgdonI didn't think there were too many issues. That is good.
The patch looks fine to me! One note:
It is OK not to have a "line ending in :" here, because it is preceded by a header. However, I agree in this case it may make things clearer.
So, I applied the patch and committed it. Thanks!