Re: [Discussion] About the wiki….
+1 for migrating away from the Wiki. I am not a fan. It is too difficult to keep in-sync with the source code. It also doesn't get the loving care and review that a PR does in our community. On Tue, Jun 13, 2017 at 2:27 PM, zeo...@gmail.comwrote: > I suggested in the past and got some buy in, but never had time to move > everything into GitHub. I vote to mostly or entirely archive the wiki. > > Jon > > On Tue, Jun 13, 2017, 5:19 PM Laurens Vets wrote: > > > On 2017-06-13 14:09, Otto Fowler wrote: > > > I think there are things in the wiki that are very very out of date, to > > > the > > > extent that they are confusing people looking at Metron. > > > Basically anyone going to DOCS HOME from the site is being thrown into > > > documentation that is sure to confuse them. > > > > > > Does anyone have any ideas how we can address this? Can we prune the > > > wiki > > > and remove the out of date information ( better less than wrong )? > > > Should > > > we replace DOCS HOME with the site book link? > > > > Throw out the old/wrong stuff asap. > > > > I also wouldn't mind trying to get some structure in it but is the wiki > > still necessary if everything will be in markdown in the source > > eventually? > > > -- > > Jon >
Re: [Discussion] About the wiki….
I suggested in the past and got some buy in, but never had time to move everything into GitHub. I vote to mostly or entirely archive the wiki. Jon On Tue, Jun 13, 2017, 5:19 PM Laurens Vetswrote: > On 2017-06-13 14:09, Otto Fowler wrote: > > I think there are things in the wiki that are very very out of date, to > > the > > extent that they are confusing people looking at Metron. > > Basically anyone going to DOCS HOME from the site is being thrown into > > documentation that is sure to confuse them. > > > > Does anyone have any ideas how we can address this? Can we prune the > > wiki > > and remove the out of date information ( better less than wrong )? > > Should > > we replace DOCS HOME with the site book link? > > Throw out the old/wrong stuff asap. > > I also wouldn't mind trying to get some structure in it but is the wiki > still necessary if everything will be in markdown in the source > eventually? > -- Jon
Re: [Discussion] About the wiki….
On 2017-06-13 14:09, Otto Fowler wrote: I think there are things in the wiki that are very very out of date, to the extent that they are confusing people looking at Metron. Basically anyone going to DOCS HOME from the site is being thrown into documentation that is sure to confuse them. Does anyone have any ideas how we can address this? Can we prune the wiki and remove the out of date information ( better less than wrong )? Should we replace DOCS HOME with the site book link? Throw out the old/wrong stuff asap. I also wouldn't mind trying to get some structure in it but is the wiki still necessary if everything will be in markdown in the source eventually?
[Discussion] About the wiki….
I think there are things in the wiki that are very very out of date, to the extent that they are confusing people looking at Metron. Basically anyone going to DOCS HOME from the site is being thrown into documentation that is sure to confuse them. Does anyone have any ideas how we can address this? Can we prune the wiki and remove the out of date information ( better less than wrong )? Should we replace DOCS HOME with the site book link?