----- Original Message ----- > On Sat, Jan 15, 2011 at 1:07 PM, R.I.Pienaar < [email protected] > wrote: > > is there anything you can set so we receive notifications of edits on > this doc? > > > > > I don't believe so. This is where we have a bunch of conflicting > constraints, or at least haven't found a solution that accommodates > all of them. > > * viewable anonymously
it asked me for my password, wouldnt let me view it without, maybe its cos google knew I had a google account already due to a cookie or something i did see some anon viewers so I guess that must be it. > * low barrier to comments at end of doc (anonymous if possible) comments there aren't really great, you only have to look at the current ones there to see how hard it is to read, unindented properly etc > * low barrier to inline comments in doc (anonymous if possible) this is even worse, there isnt enough space, the comments will be longer than the doc and the context of what is being commented on is gone. You cant reply to various parts of a persons comment easily like I am doing here by commenting on each of your bullet points. It takes everything that sux about top posting outlook users as UI guidelines :) > * easy to format code snippets it doesnt do that either > * notifications of changes via email > * RSS feed neither of these. > I really thought markdown text on GitHub was going to be the ultimate > solution, and spent a while reformatting the doc in markdown until I > realized that comments on individual lines were only available for > commits. I dont know what is the best solution, but email is in every way better than google docs. > After a lot of conversations in IRC recently, I'm starting to think we > haven't done a very good job of explaining why we think something like > this is needed, so I'm curious whether this list, who are almost > certainly more experienced with the issues around writing reusable > modules, agrees that we need to be able to split data consumed by > modules out of the modules themselves. I have no doubt at all that its needed and keen to see some solution reached -- You received this message because you are subscribed to the Google Groups "Puppet Developers" 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/puppet-dev?hl=en.
