Title: Concept: Administrative Overview
Section: Basic Site Configuration
File name: config-overview.txt
Covers: An overview of the top level sections of the toolbar, and what you can expect to find under each

Attribution

See https://userguide-drupal.redesign.devdrupal.org/guidelines/guidelines.ht...

Written by https://www.drupal.org/u/halofx[Scott Wilkinson].

Checklist for this phase

- Does it follow the template?
- Have the comments and placeholder text been removed from the template?
- Is everything the topic was supposed to cover included, and nothing extra?
- If there are @todo notes, are they clear?
- If there are images included, do they include instructions for how to redo them in a comment? (Note: Screenshots do not need to be perfect. Just make a rough cut.)
- Is attribution provided?

Comments

HaloFX’s picture

Assigned: Unassigned » HaloFX
HaloFX’s picture

Status: Active » Needs work
StatusFileSize
new2.58 KB

Still a work in progress.

jhodgdon’s picture

Looking good so far!

One suggestion -- in:

*Content* - Lists existing content, and allow creation of new content. Existing content can be managed from this page also.

*Structure* - Contains a lists of links for managing structural elements of a site, such as blocks, comments, menus and taxonomy.
...

You might make this a "definition list":

Content::
  Lists existing content...
Structure::
  Contains lists of links...
jhodgdon’s picture

Issue summary: View changes

Adding checklist to issue summary.

Note: Before you finalize this, you'll need to provide the attribution information (see link in issue summary).

HaloFX’s picture

StatusFileSize
new2.87 KB

Still working on it. The Definition list is complete.

This topic seems like it could have a huge list of Related Topics and Additional Resources. How deep should it go?

Would a screenshot of the menu at the top of the article be helpful?

jhodgdon’s picture

Issue summary: View changes

Yeah right! I think in this case we shouldn't make that huge list of related topics, because you're right, pretty much everything else is "related". You can make those sections into comments, like

//==== Related topics

A screenshot of the top menu would indeed be a good idea.

The text is looking good! I think all you need to do is remove the placeholder text from the template, and add the screenshot.

Also, the attributions information doesn't go in the topic. I've copied it into the issue summary, so if you can remove it from the topic file, that would be helpful.

HaloFX’s picture

Assigned: HaloFX » Unassigned
Status: Needs work » Needs review
StatusFileSize
new5.29 KB
new1.27 KB

Ok, I think I got it.

eojthebrave’s picture

Status: Needs review » Fixed

Thanks @HaloFX, this looks great. And thanks for including the screenshot. I made on minor change, I added a comment just above the line that includes the image that describes what is in the image so that it can be re-created. And added your attribution to attributions.txt. Then I went ahead and committed this. Woohoo!

These changes will make their way to the preview site the next time that it is re-compiled.

jhodgdon’s picture

It's up! Thanks again!

Status: Fixed » Closed (fixed)

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