Re: Thoughts on tagging docs issues in GitLab
Hashem nolastname <[email protected]>
| Newsgroups | gmane.comp.gnome.documentation |
|---|---|
| Message-ID | <CAA=9LgKCE3_DJ+F2axWvD4KRkVinTe6s4L4PQ5La4rR+7TKd1Q@mail.gmail.com> |
docs-help and docs-devel don't sound too bad to me On Thu, Sep 7, 2017 at 3:12 PM, Shaun McCance <[email protected]> wrote: > On Thu, 2017-09-07 at 16:53 +0100, David King wrote: > > On 2017-09-07 11:45, Shaun McCance <[email protected]> wrote: > > > > > > Standardized tag names for docs will help us a lot. Heck, we never > > > did > > > manage to get standardized component names for docs in Bugzilla. If > > > we > > > get out in front of this thing, we can do better. > > > > > > I would be perfectly happy with the preopulated "documentation" > > > tag, > > > except that it's going to get used for both user and developer > > > docs. > > > There are generally two completely different collections of > > > eyeballs > > > looking at those lists. > > > > > > What about "userdocs" and "develdocs"? Or (uglier) "docsuser" and > > > "docsdevel" so they sort together and show up in a list where you'd > > > expect to see "docs" or "documentation"? > > I think "help" would be apt for end-user documentation, as it fits > > the > > directory name. Of course, it has the problem that you might get > > users > > asking for help there. For developer-oriented documentation, the > > standard "documentation" tag seems to fit well enough. > > I had thought the same thing. Use "documentation" for developer docs > and "help" for user docs. It would work out OK if everybody knows the > rules on when to use which. But it has the disadvantage of not being > self-documenting in the way "userdocs" and "develdocs" are. But as you > mention, it does nicely mirror directory names. > > -- > Shaun > > > > _______________________________________________ > gnome-doc-list mailing list > [email protected] > https://mail.gnome.org/mailman/listinfo/gnome-doc-list > _______________________________________________ gnome-doc-list mailing list [email protected] https://mail.gnome.org/mailman/listinfo/gnome-doc-list