Comment system
From GPLv3 Wiki
| Revision as of 20:01, 2 May 2006 johns (Talk | contribs) Added note about list view and how to see comments on a section. ← Previous diff |
Revision as of 20:03, 2 May 2006 johns (Talk | contribs) Next diff → |
||
| Line 1: | Line 1: | ||
| A few tips on getting the most out of the commenting system, pending "real" documentation: | A few tips on getting the most out of the commenting system, pending "real" documentation: | ||
| - | * To see a list-view of the comments and issues, use the [http://gplv3.fsf.org/comments/rt/readsay.html?Query=%20'CF.NoteUrl'%20LIKE%20'gplv3-draft-1'&Order=DESC list link]. As the drafting process goes on, comments are being grouped together into common issues for the drafters to evaluate. This view is good for seeing what those issues are and which comments pertain to each issue. | + | ==Views== |
| - | * I would like to be able to view all comments associated with a particular section. | + | ===Default View=== |
| You can click on the highlighting on a particular section in order to see the comments pertaining to that section. | You can click on the highlighting on a particular section in order to see the comments pertaining to that section. | ||
| Line 9: | Line 9: | ||
| Click "search" on the statusbar, and search for "Section id contains [ section id ]". You can learn the section id by going to "read/say more" for a comment from that section (where the section id is also a link to the query for all comments on that section). You can switch between the license view and the list/threaded view with the "see on license" and "list" links on the status bar. (soon we'll change the link that it offers, from linking just to the sentence-level query, to offering breadcrumbs-style links to the section, the paragraph, and the sentence each.) | Click "search" on the statusbar, and search for "Section id contains [ section id ]". You can learn the section id by going to "read/say more" for a comment from that section (where the section id is also a link to the query for all comments on that section). You can switch between the license view and the list/threaded view with the "see on license" and "list" links on the status bar. (soon we'll change the link that it offers, from linking just to the sentence-level query, to offering breadcrumbs-style links to the section, the paragraph, and the sentence each.) | ||
| - | * The RSS feed linked at the top of each page is a feed for the search query that is currently being shown. So you may subscribe to a feed just of comments on section "licensecompat" or "licensingpatents", or even on "licensingpatents.p0.s1". Or "s1" to see all the comments on the first sentences of all paragraphs. Or on comments by a particular user, or comments containing particular text. | ||
| - | * The current (daunting-to-install) [http://gplv3.fsf.org/comments/source/stet-2006-03-14.tar.bz2 source is available]. | + | ===List View=== |
| + | |||
| + | To see a list-view of the comments and issues, use the [http://gplv3.fsf.org/comments/rt/readsay.html?Query=%20'CF.NoteUrl'%20LIKE%20'gplv3-draft-1'&Order=DESC list link]. As the drafting process goes on, comments are being grouped together into common issues for the drafters to evaluate. This view is good for seeing what those issues are and which comments pertain to each issue. | ||
| + | |||
| + | ==Feeds== | ||
| + | |||
| + | The RSS feed linked at the top of each page is a feed for the search query that is currently being shown. So you may subscribe to a feed just of comments on section "licensecompat" or "licensingpatents", or even on "licensingpatents.p0.s1". Or "s1" to see all the comments on the first sentences of all paragraphs. Or on comments by a particular user, or comments containing particular text. | ||
| + | |||
| + | ==Source== | ||
| + | |||
| + | The current (daunting-to-install) [http://gplv3.fsf.org/comments/source/stet-2006-03-14.tar.bz2 source is available]. | ||
Revision as of 20:03, 2 May 2006
A few tips on getting the most out of the commenting system, pending "real" documentation:
Contents |
Views
Default View
You can click on the highlighting on a particular section in order to see the comments pertaining to that section.
Click "search" on the statusbar, and search for "Section id contains [ section id ]". You can learn the section id by going to "read/say more" for a comment from that section (where the section id is also a link to the query for all comments on that section). You can switch between the license view and the list/threaded view with the "see on license" and "list" links on the status bar. (soon we'll change the link that it offers, from linking just to the sentence-level query, to offering breadcrumbs-style links to the section, the paragraph, and the sentence each.)
List View
To see a list-view of the comments and issues, use the list link. As the drafting process goes on, comments are being grouped together into common issues for the drafters to evaluate. This view is good for seeing what those issues are and which comments pertain to each issue.
Feeds
The RSS feed linked at the top of each page is a feed for the search query that is currently being shown. So you may subscribe to a feed just of comments on section "licensecompat" or "licensingpatents", or even on "licensingpatents.p0.s1". Or "s1" to see all the comments on the first sentences of all paragraphs. Or on comments by a particular user, or comments containing particular text.
Source
The current (daunting-to-install) source is available.
