You are viewing a plain text version of this content. The canonical link for it is here.
Posted to doc@openoffice.apache.org by marcia wilbur <ai...@well.com> on 2021/02/10 03:17:38 UTC
GNU Linux install guide - 6 pages....
Hi.
I realize I did prematurely create a simple installation guide for GNU Linux users without realizing the licensure.
This could be fixed.
However, I received an email off this list from Keith stating the guide was not peer reviewed.
I wonder, were these guides?
http://openoffice-uni.org/
this was also posted online.
One recommendation - please make the onboarding simple and straightforward for those volunteering in this effort for documentation.
I was just trying to be a positive force and influence for this project, but really and am disappointed by the docs team - well, particularly and the continued push to use the old docs, mix method of documentation and as I heard during fosdem = the idea... this project cannot move forward as a current offering - like a corporation
I do encourage the docs team to move forward with current useful documentation for the project, working with developers in an effort to drive innovation.
I hope you can move forward with these attitudes in a positive manner.
Keith, all future communication should be made here.
Thank you.
---------------------------------------------------------------------
To unsubscribe, e-mail: doc-unsubscribe@openoffice.apache.org
For additional commands, e-mail: doc-help@openoffice.apache.org
RE: GNU Linux install guide - 6 pages....
Posted by Dennis Hamilton <or...@msn.com>.
Marcia, I agree that the governance, workflow, and review requirements for the AOOdocs effort need to be established and made clear. I also agree that making onboarding simple and establishing how to work with GitHub as a place for a documentation project is challenging.
I also must point out, in-line below, that openoffice-uni.org has nothing to do with openoffice.org and, in particular, the Apache OpenOffice project.
Marcia, I am unclear where you provided the GNU Linux install guide. Is it available for download?
"PEER REVIEW" OR NOT
Although there are mechanisms with regard to Apache project source code and the development of releases, these are known mainly by the developers. The software development approach does provide for *authorized* committers to commit materials and changes first, having "peer review" review second (where peers are mainly *authorized* committers). But moving to a "release" state takes more than that, including public review periods.
A relevant example with regard to apache/openoffice-docs is that GitHub user DiGro has been granted contributor rights, as you can see on the openoffice-docs home page: https://github.com/apache/openoffice-docs . Previously, I think this was for FJCC. So there is now an issue about anonymity. You can see from https://github.com/apache/openoffice-docs/tree/Getting-Sarted-Guide/Review that FJCC was able to commit changes directly. The second column in that list identifies what the "commit message" was for the latest (sometimes only) action with regard to those files. The last column indicates how ling it has been since that occurred.
For openoffice-docs, Keith is essentially lead developer, at least until governance and on-boarding are smoothed out. I have no idea about the appearance of DiGro as a contributor in the place of FJCC who we knew to be Francis.
- Dennis
-----Original Message-----
From: marcia wilbur <ai...@well.com>
Sent: Tuesday, February 9, 2021 19:18
To: doc@openoffice.apache.org
Cc: dev@openoffice.apache.org
Subject: GNU Linux install guide - 6 pages....
Hi.
I realize I did prematurely create a simple installation guide for GNU Linux users without realizing the licensure.
This could be fixed.
However, I received an email off this list from Keith stating the guide was not peer reviewed.
I wonder, were these guides?
[orcmid about USAGE OF APACHE AND AOO MARKS AND TRADEMARKS]
http://openoffice-uni.org/
[end orcmid]
this was also posted online.
[orcmid]
Openoffice-uni.org is not part of either openoffice.org or the Apache OpenOffice Project.
Note this statement buried at the bottom of the page: "This website is not affiliated with the Apache Software Foundation."
I do not know whether this site is in conformance with Apache Software Foundation trademark requirements. That is a matter for the Apache OpenOffice Project Management Committee (PMC) to determine. I have no insight into any deliberations the PMC may have had about this site.
The question about peer-reviewing of documents provided via openoffice-uni.org is not relevant to the AOOdocs effort.
Marcia, if you want to self-publish documents, you are free to do so. Just do not imply that those are products of the Apache OpenOffice project and do not use marks of the Apache Software Foundation and Apache OpenOffice that imply any association.
This is not a comment on the worthiness of the openoffice-uni.org to provide materials for students. It is about the appearance of association with the Apache OpenOffice Project. Disclaimers in the "fine print" to not compensate for that, in my opinion.
[end orcmid]
One recommendation - please make the onboarding simple and straightforward for those volunteering in this effort for documentation.
I was just trying to be a positive force and influence for this project, but really and am disappointed by the docs team - well, particularly and the continued push to use the old docs, mix method of documentation and as I heard during fosdem = the idea... this project cannot move forward as a current offering - like a corporation
I do encourage the docs team to move forward with current useful documentation for the project, working with developers in an effort to drive innovation.
I hope you can move forward with these attitudes in a positive manner.
Keith, all future communication should be made here.
Thank you.
---------------------------------------------------------------------
To unsubscribe, e-mail: doc-unsubscribe@openoffice.apache.org
For additional commands, e-mail: doc-help@openoffice.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: doc-unsubscribe@openoffice.apache.org
For additional commands, e-mail: doc-help@openoffice.apache.org
Re: GNU Linux install guide - 6 pages....
Posted by "Keith N. McKenna" <ke...@comcast.net>.
On 2/11/2021 7:30 PM, F Campos Costero wrote:
> Well, my day yesterday did not go as planned and I did not get back to
> this.
> What, if anything, needs to be done with respect to Marcia's Debian Install
> Guide? I looked through it and everything looks right, though I do not have
> the commands all memorized, so there could possibly be an error. It would
> be good to give other people a chance to review documents before posting
> them but it is simple enough to review such a short document now. We are
> all developing the process and learning as we go, so we should expect some
> hiccups.
>
> Keith - do you have any comments on Marcia's email?
>
> Marcia - are you willing to give any more feedback about how to improve
> what we are doing?
>
> I am keeping this message on the docs list, since I do not think general
> members of the dev list will want to see a detailed discussion. Feel free
> to correct me on that.
>
> Francis
The problem is with the license and in the fact that she neglected to
inform the list that she intended to right the guide by herself and not
as a collaborative effort with the team.
Yes I do have comments for Marcia, and I will post them most likely in
the morning.
Regards
Keith
>
> On Tue, Feb 9, 2021 at 9:43 PM F Campos Costero <fj...@gmail.com>
> wrote:
>
>>
>> Sorry, I did not do Reply All.
>>
>> ---------- Forwarded message ---------
>> From: F Campos Costero <fj...@gmail.com>
>> Date: Tue, Feb 9, 2021 at 9:41 PM
>> Subject: Re: GNU Linux install guide - 6 pages....
>> To: <de...@openoffice.apache.org>
>>
>>
>> Marcia,
>> I am very sorry you have had a bad experience trying to contribute to the
>> docs team. I have just gotten involved myself and my views certainly do not
>> represent any official or team perspective. The docs group has made very
>> little progress for a long time due to many obstacles but I think there is
>> finally a bit of movement with the repair of the MediaWiki extension, the
>> new repository and the decision to make odt the base format, insulating
>> most volunteers from technical issues that caused a lot of uncertainty. You
>> were certainly a very positive contributor and I was very much looking
>> forward to working with you on the larger documents. Please do continue on.
>> I also strongly support your concerns being openly addressed and rectified
>> where that is possible.
>>
>> I want to review the previous emails before saying more, particularly
>> because it is getting late for me. I hope that tomorrow I can discuss with
>> you and other interested parties how to improve the docs team.
>>
>> Francis
>>
>> On Tue, Feb 9, 2021 at 8:17 PM marcia wilbur <ai...@well.com> wrote:
>>
>>> Hi.
>>>
>>> I realize I did prematurely create a simple installation guide for GNU
>>> Linux users without realizing the licensure.
>>> This could be fixed.
>>> However, I received an email off this list from Keith stating the guide
>>> was not peer reviewed.
>>>
>>> I wonder, were these guides?
>>> http://openoffice-uni.org/
>>>
>>> this was also posted online.
>>>
>>> One recommendation - please make the onboarding simple and
>>> straightforward for those volunteering in this effort for documentation.
>>>
>>> I was just trying to be a positive force and influence for this project,
>>> but really and am disappointed by the docs team - well, particularly and
>>> the continued push to use the old docs, mix method of documentation and as
>>> I heard during fosdem = the idea... this project cannot move forward as a
>>> current offering - like a corporation
>>>
>>> I do encourage the docs team to move forward with current useful
>>> documentation for the project, working with developers in an effort to
>>> drive innovation.
>>>
>>> I hope you can move forward with these attitudes in a positive manner.
>>>
>>> Keith, all future communication should be made here.
>>>
>>> Thank you.
>>>
>>>
>>>
>>>
>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
>>> For additional commands, e-mail: dev-help@openoffice.apache.org
>>>
>>>
Re: GNU Linux install guide - 6 pages....
Posted by F Campos Costero <fj...@gmail.com>.
Well, my day yesterday did not go as planned and I did not get back to
this.
What, if anything, needs to be done with respect to Marcia's Debian Install
Guide? I looked through it and everything looks right, though I do not have
the commands all memorized, so there could possibly be an error. It would
be good to give other people a chance to review documents before posting
them but it is simple enough to review such a short document now. We are
all developing the process and learning as we go, so we should expect some
hiccups.
Keith - do you have any comments on Marcia's email?
Marcia - are you willing to give any more feedback about how to improve
what we are doing?
I am keeping this message on the docs list, since I do not think general
members of the dev list will want to see a detailed discussion. Feel free
to correct me on that.
Francis
On Tue, Feb 9, 2021 at 9:43 PM F Campos Costero <fj...@gmail.com>
wrote:
>
> Sorry, I did not do Reply All.
>
> ---------- Forwarded message ---------
> From: F Campos Costero <fj...@gmail.com>
> Date: Tue, Feb 9, 2021 at 9:41 PM
> Subject: Re: GNU Linux install guide - 6 pages....
> To: <de...@openoffice.apache.org>
>
>
> Marcia,
> I am very sorry you have had a bad experience trying to contribute to the
> docs team. I have just gotten involved myself and my views certainly do not
> represent any official or team perspective. The docs group has made very
> little progress for a long time due to many obstacles but I think there is
> finally a bit of movement with the repair of the MediaWiki extension, the
> new repository and the decision to make odt the base format, insulating
> most volunteers from technical issues that caused a lot of uncertainty. You
> were certainly a very positive contributor and I was very much looking
> forward to working with you on the larger documents. Please do continue on.
> I also strongly support your concerns being openly addressed and rectified
> where that is possible.
>
> I want to review the previous emails before saying more, particularly
> because it is getting late for me. I hope that tomorrow I can discuss with
> you and other interested parties how to improve the docs team.
>
> Francis
>
> On Tue, Feb 9, 2021 at 8:17 PM marcia wilbur <ai...@well.com> wrote:
>
>> Hi.
>>
>> I realize I did prematurely create a simple installation guide for GNU
>> Linux users without realizing the licensure.
>> This could be fixed.
>> However, I received an email off this list from Keith stating the guide
>> was not peer reviewed.
>>
>> I wonder, were these guides?
>> http://openoffice-uni.org/
>>
>> this was also posted online.
>>
>> One recommendation - please make the onboarding simple and
>> straightforward for those volunteering in this effort for documentation.
>>
>> I was just trying to be a positive force and influence for this project,
>> but really and am disappointed by the docs team - well, particularly and
>> the continued push to use the old docs, mix method of documentation and as
>> I heard during fosdem = the idea... this project cannot move forward as a
>> current offering - like a corporation
>>
>> I do encourage the docs team to move forward with current useful
>> documentation for the project, working with developers in an effort to
>> drive innovation.
>>
>> I hope you can move forward with these attitudes in a positive manner.
>>
>> Keith, all future communication should be made here.
>>
>> Thank you.
>>
>>
>>
>>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
>> For additional commands, e-mail: dev-help@openoffice.apache.org
>>
>>
Fwd: GNU Linux install guide - 6 pages....
Posted by F Campos Costero <fj...@gmail.com>.
Sorry, I did not do Reply All.
---------- Forwarded message ---------
From: F Campos Costero <fj...@gmail.com>
Date: Tue, Feb 9, 2021 at 9:41 PM
Subject: Re: GNU Linux install guide - 6 pages....
To: <de...@openoffice.apache.org>
Marcia,
I am very sorry you have had a bad experience trying to contribute to the
docs team. I have just gotten involved myself and my views certainly do not
represent any official or team perspective. The docs group has made very
little progress for a long time due to many obstacles but I think there is
finally a bit of movement with the repair of the MediaWiki extension, the
new repository and the decision to make odt the base format, insulating
most volunteers from technical issues that caused a lot of uncertainty. You
were certainly a very positive contributor and I was very much looking
forward to working with you on the larger documents. Please do continue on.
I also strongly support your concerns being openly addressed and rectified
where that is possible.
I want to review the previous emails before saying more, particularly
because it is getting late for me. I hope that tomorrow I can discuss with
you and other interested parties how to improve the docs team.
Francis
On Tue, Feb 9, 2021 at 8:17 PM marcia wilbur <ai...@well.com> wrote:
> Hi.
>
> I realize I did prematurely create a simple installation guide for GNU
> Linux users without realizing the licensure.
> This could be fixed.
> However, I received an email off this list from Keith stating the guide
> was not peer reviewed.
>
> I wonder, were these guides?
> http://openoffice-uni.org/
>
> this was also posted online.
>
> One recommendation - please make the onboarding simple and straightforward
> for those volunteering in this effort for documentation.
>
> I was just trying to be a positive force and influence for this project,
> but really and am disappointed by the docs team - well, particularly and
> the continued push to use the old docs, mix method of documentation and as
> I heard during fosdem = the idea... this project cannot move forward as a
> current offering - like a corporation
>
> I do encourage the docs team to move forward with current useful
> documentation for the project, working with developers in an effort to
> drive innovation.
>
> I hope you can move forward with these attitudes in a positive manner.
>
> Keith, all future communication should be made here.
>
> Thank you.
>
>
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
> For additional commands, e-mail: dev-help@openoffice.apache.org
>
>
Re: GNU Linux install guide - 6 pages....
Posted by F Campos Costero <fj...@gmail.com>.
Marcia,
I am very sorry you have had a bad experience trying to contribute to the
docs team. I have just gotten involved myself and my views certainly do not
represent any official or team perspective. The docs group has made very
little progress for a long time due to many obstacles but I think there is
finally a bit of movement with the repair of the MediaWiki extension, the
new repository and the decision to make odt the base format, insulating
most volunteers from technical issues that caused a lot of uncertainty. You
were certainly a very positive contributor and I was very much looking
forward to working with you on the larger documents. Please do continue on.
I also strongly support your concerns being openly addressed and rectified
where that is possible.
I want to review the previous emails before saying more, particularly
because it is getting late for me. I hope that tomorrow I can discuss with
you and other interested parties how to improve the docs team.
Francis
On Tue, Feb 9, 2021 at 8:17 PM marcia wilbur <ai...@well.com> wrote:
> Hi.
>
> I realize I did prematurely create a simple installation guide for GNU
> Linux users without realizing the licensure.
> This could be fixed.
> However, I received an email off this list from Keith stating the guide
> was not peer reviewed.
>
> I wonder, were these guides?
> http://openoffice-uni.org/
>
> this was also posted online.
>
> One recommendation - please make the onboarding simple and straightforward
> for those volunteering in this effort for documentation.
>
> I was just trying to be a positive force and influence for this project,
> but really and am disappointed by the docs team - well, particularly and
> the continued push to use the old docs, mix method of documentation and as
> I heard during fosdem = the idea... this project cannot move forward as a
> current offering - like a corporation
>
> I do encourage the docs team to move forward with current useful
> documentation for the project, working with developers in an effort to
> drive innovation.
>
> I hope you can move forward with these attitudes in a positive manner.
>
> Keith, all future communication should be made here.
>
> Thank you.
>
>
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
> For additional commands, e-mail: dev-help@openoffice.apache.org
>
>