Max Battcher napisał(a): > Pauli Virtanen wrote: >> I think the "change suggestions" should be something similar to bug >> reports, with fixed workflow that enables developers/doc editors to >> easily find out present suggestions, possibly discuss them with the >> submitter, and finally mark them as done or invalid. At least to me this >> looks something similar to what an issuer tracker software does. > > I assumed it meant more along the lines of like the > per-paragraph/section comments of, for instance, the Django Book.
Thanks for pointing this out Max! Somehow it won't work on my Opera (and that explains why I haven't seen it before), but it's nice anyway and it definitely is better than keeping the comments at the bottom of every page. Assuming that I will do something similar to what I see at Django Book site, I wonder now if we couldn't mix comments and "change suggestions" features together. In both cases we should provide a way for developers to discuss the suggestions and to accept or reject them. What about adding some attributes to each comment, like: - type (typo or missing sign / grammar or style problem / wrong description / bad code / proposal) - status (open / accepted / rejected) - priority (low / normal / high) Then we could use different colours for the baloons (as it is called in Django Book) to indicate the kind and state of a problem. There may be many different comments under a single baloon with various types, statuses and priorities, so the colour of the baloon should rather tell us if there is any open comment for particular block and what's the priority of a comment. I imagine that we could use three tones of red (each indicating different priority) for open comments, and some other colour if there is no open comment. But the question arise: who should be able to change the status or priority of a comment? Everyone or only logged in users? > In-line comments at the point where a change should be made. Possibly > allowing for saving/shelving actual diffs from anonymous/pseudonymous > users so that they can be directly applied... Kind of file attaching? Thanks for your input, -- Regards, Wojtek Walczak, http://tosh.pl/gminick/ --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [email protected] For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en -~----------~----~----~----~------~----~------~--~---
