On 6/3/2020 2:32 AM, Peter Kovacs wrote: > 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. > Peter; Thanks for the link to the Fosdem presentation. I will take a closer look at it later today. have the grandchildren tomorrow and attempting anything that requires thought and study is night on impossible with a 9 and 11 year old in attendance.
Regards Keith > > 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 >>>>> >>>>> >>> >>>
signature.asc
Description: OpenPGP digital signature
