Skip to content
This repository was archived by the owner on Aug 15, 2019. It is now read-only.

Add page listings to the main sections#48

Open
trickeydan wants to merge 1 commit into
masterfrom
add-section-listings
Open

Add page listings to the main sections#48
trickeydan wants to merge 1 commit into
masterfrom
add-section-listings

Conversation

@trickeydan

Copy link
Copy Markdown
Collaborator

This makes the index pages of each of the sections more useful and not quite so blank!

@trickeydan trickeydan requested a review from RealOrangeOne April 8, 2018 18:22

The following topics are covered in this section:

{{% children %}}

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This really isn't necessary. The lists of children are available in the sidebar.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm inclined to agree - perhaps a listing of child pages and a quick summary of their contents would be useful, as that would provide information not present elsewhere on the page, but simply listing the children adds no useful content.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I disagree. Blank pages are bad.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The solution to blank pages shouldn't be to add redundant information - perhaps a short summary of the category would be more appropriate. If we could get a list of children to appear by default for a blank page which has children, that may be an appropriate placeholder, but putting redundant content in each page separately does not seem that wise.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agreed. A short summary is better than a small bullet point list, which doesn't look very nice anyway.

I'm fairly sure we can get some good general content on the pages anyway.

@trickeydan

Copy link
Copy Markdown
Collaborator Author

bump

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants