textpattern / textpattern.github.io

Textpattern CMS user documentation.
https://docs.textpattern.com
GNU General Public License v2.0
15 stars 17 forks source link

checklist: Sweep on strings formatting and Kramdown ToCs #126

Open wion opened 4 years ago

wion commented 4 years ago

Situation

Docs in /build, /brand, /development, /setup, /tags need a sweep for updating interface strings against easier formatting standards... https://docs.textpattern.com/brand/user-docs-guide#formatting-interface-strings).

And replacing manually-created contents lists (ToCs) with the follow lead-in line and kramdown syntax:

**One this page**:

* Table of contents
{:toc}

This Kramdown notation generates the lists automatically but leaves out h1 (titles), and h5 and h6 headers, which, even if they are used (but should be avoided when possible), don't need to be loading up the ToC too.

Checklist

Check off page when sweeped. Add any missing page. Only when the container folder is checked can the doc lists be removed, meaning the entire directory has been sweeped.

wion commented 4 years ago

Notice: I have moved the dozens of offline FAQ docs that were clogging up the /faqs directory to _../recycle/needless-faqs. If ever needed for whatever reason, we can pluck them from there, but at least they are out of the way.

https://github.com/textpattern/textpattern.github.io/commit/dd8189e5df1ae286712c22da0fb0fef2a0379eb8