Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Table of Contents vs Summary section#218

seancorfield started this conversation inIdeas
Discussion options

@bbatsov asked in#216 whether the TOC satisfied my request for a distinct "bullet point" summary of the guidelines.

The TOC items indicate whattype of guidelines there are but not theactual guidelines themselves. For example "Link Breaks in ns" just tells you that the guideline isabout newlines inns but gives no indication of whether you should or should not have them nor of when you should have them. The TOC gives you an idea of what guidelines there are and lets you get to the guideline(s) for a specific topic, but you still have to go to each section, in turn, to see what the guidelines actually are.

I agree that duplicating content introduces a maintenance overhead but there is currently no way to quickly read over just the guidelines themselves -- you have to wade through the whole document, picking them out of the rationale and examples. I think having an easy-to-read summary at the start of the document is worth that extra maintenance.

You must be logged in to vote

Replies: 1 comment

Comment options

I should clarify that the titles are pretty bad currently, as post of them were auto-generated from the anchors that guidelines used to have before the conversion to the current format. Here's the commit for reference798001a It'd be nice if we improved the titles to be both more descriptive and more consistent. I guess we'll have to do this at some point.

I agree that duplicating content introduces a maintenance overhead but there is currently no way to quickly read over just the guidelines themselves -- you have to wade through the whole document, picking them out of the rationale and examples. I think having an easy-to-read summary at the start of the document is worth that extra maintenance.

Fair enough. There might be some way to generate a TOC for each section to avoid having to do this manually.

You must be logged in to vote
0 replies
Sign up for freeto join this conversation on GitHub. Already have an account?Sign in to comment
Category
Ideas
Labels
None yet
2 participants
@seancorfield@bbatsov

[8]ページ先頭

©2009-2025 Movatter.jp