Description

wion

opened on Dec 9, 2020

Issue body actions

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)

Activity

1. wion commented on Dec 10, 2020

   

   wion

   on Dec 10, 2020

   MemberAuthor

   More actions

   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.
2. wion

   added

   NEEDS DISCUSSIONUse when a proposal is not declined but needs revisions as proposedUse when a proposal is not declined but needs revisions as proposed

   on Dec 11, 2020

Issue actions