Re: [Discussion] About the wiki….

2017-06-13 Thread Nick Allen
+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.com  wrote:

> 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….

2017-06-13 Thread zeo...@gmail.com
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….

2017-06-13 Thread Laurens Vets

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….

2017-06-13 Thread Otto Fowler
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?