|+1 for having Wiki for devs and users.|
Even though editing interface is not so native and obvious (comparing to Google docs), but, at least, it will be already put in one place and should be much more easy to search and discover.
The only my concern about Wiki (based on using it in other different projects) that, in course of time, the information becomes outdated and weak structured which makes this not so valuable and even deceptive.
On Mon, Jun 11, 2018 at 2:40 PM Kenneth Knowles <klk@xxxxxxxxxx
OK, yea, that all makes sense to me. Like this?
- site/documentation: writing just for users
- site/contribute: basic stuff as-is, writing for users to entice them, links to the next...
- wiki/contributors: contributors writing just for each other
And you also have
- wiki/users: users writing for users
Yep. We don't have to start wiki/users right away, but it could be useful down the line.
On Fri, Jun 8, 2018 at 2:18 PM Kenneth Knowles <klk@xxxxxxxxxx
I disagree strongly here - I don't think the wiki will have appropriate polish for users. Even if carefully polished I don't think the presentation style is right, and it is not flexible. Power users will find it, of course.
I wasn't imagining a wiki as a platform for developers to author documentation, rather a place for users to author content for other users (tips and tricks, handy PTransforms, etc.) at a much lower bar than expecting users to go in and update our documentation. I agree with the goal of not (further) fragmenting our documentation.
As for mixing contributor vs. user information on the same site, I think it's valuable to have some integration and treat the two as a continuum (after all, our (direct) users are already developers) and consider it an asset to have a "contribute" heading right in the main site. (Perhaps, if it's confusing, we could move it all the way to the right.) I don't think we'll be doing ourselves a favor by blinding copying all the existing docs to a wiki. That being said I think it makes sense to start playing with using a wiki, and see how much value that adds on top of what we already have.
+1 most of the contributor material could live on Wiki and there it will be easier to maintain (perhaps the lower bar for updates will lead to more information and increased maintenance). Contribution policy related material should remain on the website and go through proper review/versioning.