textpattern.github.io icon indicating copy to clipboard operation
textpattern.github.io copied to clipboard

proposed: Build a custom blog

Open wion opened this issue 4 years ago • 1 comments

URLs

Back: https://docs.textpattern.com/build/custom-blog Front: https://github.com/textpattern/textpattern.github.io/blob/master/build/custom-blog

Explanation of new page

A doc for learning to build a custom blog by unpacking and understanding the default Textpattern theme, addressing other ‘how to’ type questions people often have, and provide opportunities to segue into using themes and link to that documentation.

List of resources to support draft

(to add as a bulleted list)

To-dos

(to add as a checkbox list)

wion avatar Dec 09 '20 15:12 wion

While the title initially proposed is short and clear to the topic, putting verbs (e.g. build) or verb participles (e.g. building, or other -ing words) at front of titles always annoys me, as it's not front-loading subject terms, thus making it harder to scan title lists, a usability problem in doc index pages.

It's a challenge to avoid this however, when trying to be succinct (also good for usability). It requires syntactical tricks like I've done with the themes doc title, 'Themes: Creating, using, and sharing'. That may not be appropriate for print mediums, but effective for digital machinery.

So I'm wondering if that pattern might be adopted in docs more, including this one. For example, 'Blogs: Build one as desired'. Adding that with some other ideas:

  • Blogs: Build one as desired
  • Blog site design
  • Blog development

Thoughts welcome.

wion avatar Dec 10 '20 08:12 wion