Hi all,
Here is the talk I mentioned earlier. It explains how SuSE is Publishing
Documentation (Which is in general), and what Tools they use.
https://archive.fosdem.org/2017/schedule/event/writing_open_source_documentation/
Hope it is inspiring on creating a new documentation process.
I am happy that we have consent on the general direction.
Great!
All the best
Peter
Am 02.06.20 um 22:14 schrieb F Campos Costero:
Thanks to everyone for the feedback. I will start to look at how to make
actual documents from the DocBook output of Writer and I will see what I
can figure out about the documentation process. I am certainly experiencing
the feeling of being lost on a new project. I did subscribe to the doc mail
list and that might be the place for further discussions about how to get
the documentation work active again.
Francis
On Tue, Jun 2, 2020 at 10:40 AM Keith N. McKenna <keith.mcke...@comcast.net>
wrote:
On 6/1/2020 10:51 PM, F Campos Costero wrote:
Peter - I regret that my suggestion came across as wanting to "boss
people
around". I was responding really to this comment earlier in the thread
Because all people who expressed interest expected they are told what
needs to be done where. They did not felt
comfortable to figure that out on their own.
All I meant was that a solution could be to provide such people with
concrete suggestions of what to do first. Of course that can take into
account their interests, skill level and available time. I am sure lists
of
possible contributions can be helpful for them to make a decision and it
would make sense to start with that. But the success rate of recruiting
using the self-directed approach has been very low. I do not understand
why
providing the option for more guidance to those who want it is so
objectionable. I expect that many people joining a project feel lost
and
would appreciate getting more direction at first. It would be natural for
them to become more independent after making a contribution or two.
I hope Keith will express his opinion on this.
I am fully in agreement with you on this not being a boss/worker
hierarchical approach but more of one of mentoring and guiding
volunteers into the "Apache Way." How that gets done is more of an
implementation detail that can be worked out and will most likely remain
a work in progress as new volunteers come forward.
Regards
Keith
Francis
On Mon, Jun 1, 2020 at 5:42 PM Peter Kovacs <pe...@apache.org> wrote:
Hi all,
Am 02.06.20 um 00:23 schrieb F Campos Costero:
I am not sure that this part of the process has to remain as it is.
Unfortunately that is not going to change a whole lot. Just as the
development effort is self directed so is the Documentation effort and
all volunteers are advised of that.
If we can increase participation in the documentation work by having
someone to assign tasks to others, that seems like a reasonable change
to
make. I am willing to take on coordinating the assignments if others
can
help create a reasonable list of tasks. To be clear, if someone wants
to
be
self directed, that would be great. If someone feels more comfortable
being
given a task, having a specific person to contact for help and perhaps
having a little checking in on progress, I can do that. I have no
training
in technical writing. I took a quick look at DocBook and it does not
seem
conceptually difficult, so I can try to learn that. If someone can give
me
a little help at first, I would appreciate it.
I think there is a miss understanding. I do not believe that we should
actively assign tasks and boss people around.
Think of it as a suggestive list of where someone could do something.
How it is organized, is not important.
It could be a list on ta wikies discussion side. It can be a tasklist on
Jira, Bugzilla or mwiki, or cwiki.
The Idea is to have "one" place where people can inform them selfs on
the existing consent.
Just some Ideas where I tried to describe what we have to do in the
development section:
https://issues.apache.org/jira/secure/RapidBoard.jspa?rapidView=301&projectKey=OPENOFFICE&selectedIssue=OPENOFFICE-76
https://cwiki.apache.org/confluence/display/OOOUSERS/Development+Improvement
https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=67633711
As you see it is unordered. And I am experimenting a lot. And I am
moving between Jira and Cwiki.
But I am becoming better in being able to explain people what Issues do
we have where. And what could be an easier task to do and what is more
difficult.
But I really believe that we should leave the choice what people do to
them.
And If you look around what I do is not new. MWiki is full of pages
where people describe what we should do and how. (That is the most
depressing part on the project, because it is all gobe, and give people
a tomb feeling.
But at the same time you learn so much from their Ideas. If we can
standardize somehow these Ideas, and remove names. I think it would
lower the barrier in getting involved.
If you feel this is the right way, I invite you to figure a way. If you
want anything to be done on Jira, just give me a shout. I will create a
document component, and create a kanban board for you. No Problem.
But you can also use whatever else we have, at our disposal.
If you are wondering who I am, I have been a moderator on the user
forum
for about 10 years.
That is really nice. There is so little exchange between the dev mailing
list and the support team.
All the best
Peter
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@openoffice.apache.org
For additional commands, e-mail: dev-h...@openoffice.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@openoffice.apache.org
For additional commands, e-mail: dev-h...@openoffice.apache.org
