On Tuesday, 6 February 2018 12:53:17 CET Telles Nobrega wrote: > Hi folks, > > as we discussed in our last meeting, tomorrow (Wednesday 7th) we are going > to do a first overview of our documentation in order to gather the maximum > information of where we need to fix, add or remove stuff so we don't waste > time at PTG on this. > > We can fix small problems but the main goal is to have a list of places > that need fixing, so we can use during Rocky cycle as a guide for > documentation improvement.
Of course I think that if we find that something not trivial can be fixed anyway, no one is going to complain. > > In order to maiximize our reach it would good to split where each of us > will be looking at the documentation, so I thought: > > From: > https://docs.openstack.org/sahara/latest/ we can split in 4 parts, since > user guide seems to be biggest one person would work on User Guide, and > other 3 each work on 2 topics (we can choose freely) I can help with this, but I will start with sahara-tests (see below); during the day, if no one else is working on other parts, I will start reading some of those other documents. > > From: > https://docs.openstack.org/sahara-tests/latest/ it seems very direct, maybe > tosky and I can take a look at it (everyone is free to do so as well) I will focus on this at first. > > If anyone needs help, or the rabbit hole grows too much we can always > reorganize the split. > > What do you think of it? I would say: let's start reading, and maybe we can find that there are some topics that can be covered throughout all the documents: reference to technologies that are no more valid, or the reference to the pre-built images, etc, and fix them first. Let's see. Ciao -- Luigi __________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev