On Fri, Feb 26, 2016 at 10:49 PM, Nigel Williams
wrote:
> On Fri, Feb 26, 2016 at 11:28 PM, John Spray wrote:
>> Some projects have big angry warning banners at the top of their
>> master branch documentation, I think perhaps we should do that too,
>> and at the same time try to find a way to ste
On Sat, Feb 27, 2016 at 12:08 AM, Andy Allan wrote:
> When I made a (trivial, to be fair) documentation PR it was dealt with
> immediately, both when I opened it, and when I fixed up my commit
> message. I'd recommend that if anyone sees anything wrong with the
> docs, just submit a PR with the fi
On Fri, Feb 26, 2016 at 11:28 PM, John Spray wrote:
> Some projects have big angry warning banners at the top of their
> master branch documentation, I think perhaps we should do that too,
> and at the same time try to find a way to steer google hits to the
> latest stable branch docs rather than
On Fri, Feb 26, 2016 at 6:08 AM, Andy Allan wrote:
> including a nice big obvious version switcher banner on every
> page.
We used to have something like this, but we didn't set it back up when
we migrated the web servers to new infrastructure a while back. It was
using https://github.com/alfredo
On 26 February 2016 at 05:53, Christian Balzer wrote:
> I have a feeling some dedicated editors including knowledgeable and vetted
> volunteers would do a better job that just spamming PRs, which tend to be
> forgotten/ignored by the already overworked devs.
When I made a (trivial, to be fair)
On Fri, Feb 26, 2016 at 5:24 AM, Nigel Williams
wrote:
> On Fri, Feb 26, 2016 at 4:09 PM, Adam Tygart wrote:
>> The docs are already split by version, although it doesn't help that
>> it isn't linked in an obvious manner.
>>
>> http://docs.ceph.com/docs/master/rados/operations/cache-tiering/
>
>
On Fri, Feb 26, 2016 at 5:53 AM, Christian Balzer wrote:
>
> Hello,
>
> On Thu, 25 Feb 2016 23:09:52 -0600 Adam Tygart wrote:
>
>> The docs are already split by version, although it doesn't help that
>> it isn't linked in an obvious manner.
>>
>> http://docs.ceph.com/docs/master/rados/operations/c
Hello,
On Thu, 25 Feb 2016 23:09:52 -0600 Adam Tygart wrote:
> The docs are already split by version, although it doesn't help that
> it isn't linked in an obvious manner.
>
> http://docs.ceph.com/docs/master/rados/operations/cache-tiering/
>
> http://docs.ceph.com/docs/hammer/rados/operations
Unfortunately, what seems to happen as users (and developers) get more
in tune with software projects, we forget what is and isn't common
knowledge.
Perhaps said "wall of text" should be a glossary of terms. A
definition list, something that can be open in one tab, and define any
ceph-specific or
On Fri, Feb 26, 2016 at 4:09 PM, Adam Tygart wrote:
> The docs are already split by version, although it doesn't help that
> it isn't linked in an obvious manner.
>
> http://docs.ceph.com/docs/master/rados/operations/cache-tiering/
Is there any reason to keep this "master" (version-less variant)
The docs are already split by version, although it doesn't help that
it isn't linked in an obvious manner.
http://docs.ceph.com/docs/master/rados/operations/cache-tiering/
http://docs.ceph.com/docs/hammer/rados/operations/cache-tiering/
Updating the documentation takes a lot of effort by all in
Hello,
On Fri, 26 Feb 2016 15:59:51 +1100 Nigel Williams wrote:
> On Fri, Feb 26, 2016 at 3:10 PM, Christian Balzer wrote:
>
> > Then we come to a typical problem for fast evolving SW like Ceph,
> > things that are not present in older versions.
>
>
> I was going to post on this too (I had s
On Fri, Feb 26, 2016 at 3:10 PM, Christian Balzer wrote:
> Then we come to a typical problem for fast evolving SW like Ceph, things
> that are not present in older versions.
I was going to post on this too (I had similar frustrations), and would
like to propose that a move to splitting the docu
Hello,
I know somebody will ask me to open a tracker issue, etc, but I feel
sufficiently frustrated to rant a bit here.
Case in point:
http://docs.ceph.com/docs/master/rados/operations/cache-tiering/
Let me start on a positive note, though.
Somebody pretty recently added the much needed detai
14 matches
Mail list logo
