Note: For guidelines and instructions pages linked below, log in with user name / password: drupal/drupal.

Task for this issue

Copy edit the following topic:

Title: Concept: Development Sites
Section: Extending and Customizing Your Site
File name: install-dev-sites.txt

Look for:
- Typographical errors
- Spelling errors
- Grammar and usage errors
- Punctuation problems
- Adherence to the project's editing guidelines: https://userguide_new-drupal.dev.devdrupal.org/guidelines/guidelines-edi... (access: drupal / drupal )
- Adherence to the project's writing guidelines: https://userguide_new-drupal.dev.devdrupal.org/guidelines/guidelines-wri... (access: drupal / drupal )
- Formatting problems in the output. The User guide output can be found on: https://userguide_new-drupal.dev.devdrupal.org/d8guide/en/index.html (access: drupal / drupal )

Note that the "single-issue" guidelines in the Editing guidelines page, as well as the entire Writing guidelines page, should have already been enforced. But it is still a good idea to at least check them quickly.

Instructions

See https://userguide_new-drupal.dev.devdrupal.org/guidelines/instructions.h... -- but skip the section on finding a task to do, since you have selected this one.

Checklist for this task

- Is a patch file provided? If only one or a few topics were edited, you can instead attach the updated source file(s).
- Is the edit complete and correct?
- Is the work free from additional edits outside the scope of the provided guidelines or task?
- Is attribution provided? See https://userguide_new-drupal.dev.devdrupal.org/guidelines/guidelines.htm...

CommentFileSizeAuthor
#3 user_guide-install_dev_sites-2754563-3.patch2.36 KBjojyja

Comments

jhodgdon created an issue. See original summary.

jojyja’s picture

jojyja commented
Assigned: Unassigned » jojyja

I'm taking this up.

jojyja’s picture

jojyja commented
Assigned: jojyja » Unassigned
Status: Active » Needs review
StatusFileSize
new user_guide-install_dev_sites-2754563-3.patch2.36 KB

Find attached the patch. The main change I made was to the 2nd paragraph because I felt the 1st paragraph already offered a nice intro about the sites while the list below talked about them in great detail.

  • jhodgdon committed 54b085f on 8.x-0.x authored by jojyja 
    Issue #2754563 by jojyja: Copy edit install-dev-sites.txt
jhodgdon’s picture

jhodgdon
she/her
Primary language English
commented
Status: Needs review » Fixed

Nice! I like how you made the page more concise.

One note:

+++ b/source/en/install-dev-sites.txt
@@ -16,22 +16,17 @@ Development Sites are different copies of the same site used for
-on new features, bug fixes, theming, configuration, etc. in their local
+on new features, bug fixes, theming and configuration in their local

Changing "etc." to "and" is a good idea. Thanks!

However, we always want to use serial commas -- see guidelines near the bottom of this page:
http://wren/~api7/guidelines/guidelines-editing.html
So:

apples, oranges, and lemons
not
apples, oranges and lemons

I can put that in (i.e., a comma after "theming") -- just letting you know for the next editing project. ;)

One other note: I think this list of sites would be better, instead of bullets and bold text, as a definition list, so I also made that formatting change.

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.