Re: svn commit: r1820671 - in /ofbiz/tools: documentation/BuildBot/BuildBo
Locked
Re: svn commit: r1820671 - in /ofbiz/tools: documentation/BuildBot/BuildBo
 
|
Re: svn commit: r1820671 - in /ofbiz/tools: documentation/BuildBot/BuildBo
Administrator
|
Re: svn commit: r1820671 - in /ofbiz/tools: documentation/BuildBot/BuildBo
|
|
Re: svn commit: r1820671 - in /ofbiz/tools: documentation/BuildBot/BuildBo
|
In reply to this post by Jacques Le Roux
I think the (valid) point is that documentation should be written in a
neutral form and not from a personal perspective. They should also not express personal opinions by single persons. If we want to express opinions at all, they should be officially decided by the community explicitly. It feels somewhat strange that you want others to correct this instead of doing it yourself. Michael Am 11.01.18 um 09:29 schrieb Jacques Le Roux: > As I said, feel free to improve. You can remove this section if you want > > Jacques > > Le 11/01/2018 à 07:19, Taher Alkhateeb a écrit : >> Why are you putting your opinion and referencing pros and cons of >> buildbot >> in a documentation file? Documentation is supposed to be a source for >> explaining what things are and how they work, not what you think of >> them! >> Typing "IMO" in a documentation is really strange to me. >> >> On Jan 9, 2018 6:20 PM, <[hidden email]> wrote: >> >>> Author: jleroux >>> Date: Tue Jan 9 15:20:58 2018 >>> New Revision: 1820671 >>> >>> URL: http://svn.apache.org/viewvc?rev=1820671&view=rev >>> Log: >>> Fixes(?) MD syntax for HTML import >>> >>> Modified: >>> ofbiz/tools/documentation/BuildBot/BuildBot.md >>> ofbiz/tools/wiki-files/BuildBot/BuildBot.md.html >>> >>> Modified: ofbiz/tools/documentation/BuildBot/BuildBot.md >>> URL: http://svn.apache.org/viewvc/ofbiz/tools/documentation/ >>> BuildBot/BuildBot.md?rev=1820671&r1=1820670&r2=1820671&view=diff >>> ============================================================ >>> ================== >>> --- ofbiz/tools/documentation/BuildBot/BuildBot.md (original) >>> +++ ofbiz/tools/documentation/BuildBot/BuildBot.md Tue Jan 9 15:20:58 >>> 2018 >>> @@ -23,6 +23,7 @@ BuilbBot documentation >>> OFBiz uses [BuilbBot](https://en.wikipedia.org/wiki/Buildbot) as its >>> Continuous Integration (CI) tool. There are other CI tools [used at the >>> ASF](https://ci.apache.org/). >>> >>> IMO the BuildBot pros and cons are >>> + >>> ### Pros >>> * Compared to a tool like Jenkins (those are the 2 I know) you >>> don't have >>> to use an UI, you write scripts. This is also a cons for some. >>> * The syntax is simple and well documented, some prefer intuitive UI. >>> >>> Modified: ofbiz/tools/wiki-files/BuildBot/BuildBot.md.html >>> URL: http://svn.apache.org/viewvc/ofbiz/tools/wiki-files/ >>> BuildBot/BuildBot.md.html?rev=1820671&r1=1820670&r2=1820671&view=diff >>> ============================================================ >>> ================== >>> --- ofbiz/tools/wiki-files/BuildBot/BuildBot.md.html (original) >>> +++ ofbiz/tools/wiki-files/BuildBot/BuildBot.md.html Tue Jan 9 15:20:58 >>> 2018 >>> @@ -29,8 +29,15 @@ under the License. >>> <h1 id="builbbot-documentation">BuilbBot documentation</h1> >>> <h2 id="what-is-builbbot-and-why-using-it">What is BuilbBot and why >>> using it?</h2> >>> <p>OFBiz uses <a >>> href="https://en.wikipedia.org/wiki/Buildbot">BuilbBot</a> >>> as its Continuous Integration (CI) tool. There are other CI tools <a >>> href=" >>> https://ci.apache.org/">used at the ASF</a>.</p> >>> -<p>IMO the BuildBot pros and cons are ### Pros * Compared to a tool >>> like >>> Jenkins (those are the 2 I know) you don't have to use an UI, you write >>> scripts. This is also a cons for some. * The syntax is simple and well >>> documented, some prefer intuitive UI. * The infra team at the ASF >>> provides >>> a kind of compiler which prevents to commits error in the shared script >>> (the builders are all common to the ASF)<br /> >>> -* The infra team, especially Gavin McDonald, is always ready to >>> help in a >>> very efficient way</p> >>> +<p>IMO the BuildBot pros and cons are</p> >>> +<h3 id="pros">Pros</h3> >>> +<ul> >>> +<li>Compared to a tool like Jenkins (those are the 2 I know) you don't >>> have to use an UI, you write scripts. This is also a cons for >>> some.</li> >>> +<li>The syntax is simple and well documented, some prefer intuitive >>> UI.</li> >>> +<li>The infra team at the ASF provides a kind of compiler which >>> prevents >>> to commits error in the shared script (the builders are all common >>> to the >>> ASF)<br /> >>> +</li> >>> +<li>The infra team, especially Gavin McDonald, is always ready to >>> help in >>> a very efficient way</li> >>> +</ul> >>> <h3 id="cons">Cons</h3> >>> <ul> >>> <li>You have no UI so you have to write your own scripts, some >>> prefer UIs >>> to scripts.</li> >>> >>> >>> > |
smime.p7s (5K)
Re: svn commit: r1820671 - in /ofbiz/tools: documentation/BuildBot/BuildBo
|
Administrator
|
Re: svn commit: r1820671 - in /ofbiz/tools: documentation/BuildBot/BuildBo
|
|
Thank you, Jacques.
Regards, Michael Am 11.01.18 um 10:19 schrieb Jacques Le Roux: > OK OK, done :-D > > Thanks for your collaboration > > Jacques > > > Le 11/01/2018 à 09:50, Michael Brohl a écrit : >> I think the (valid) point is that documentation should be written in >> a neutral form and not from a personal perspective. They should also >> not express personal opinions by single persons. If we want to >> express opinions at all, they should be officially decided by the >> community explicitly. >> >> It feels somewhat strange that you want others to correct this >> instead of doing it yourself. >> >> Michael >> >> >> Am 11.01.18 um 09:29 schrieb Jacques Le Roux: >>> As I said, feel free to improve. You can remove this section if you >>> want >>> >>> Jacques >>> >>> Le 11/01/2018 à 07:19, Taher Alkhateeb a écrit : >>>> Why are you putting your opinion and referencing pros and cons of >>>> buildbot >>>> in a documentation file? Documentation is supposed to be a source for >>>> explaining what things are and how they work, not what you think of >>>> them! >>>> Typing "IMO" in a documentation is really strange to me. >>>> >>>> On Jan 9, 2018 6:20 PM, <[hidden email]> wrote: >>>> >>>>> Author: jleroux >>>>> Date: Tue Jan 9 15:20:58 2018 >>>>> New Revision: 1820671 >>>>> >>>>> URL: http://svn.apache.org/viewvc?rev=1820671&view=rev >>>>> Log: >>>>> Fixes(?) MD syntax for HTML import >>>>> >>>>> Modified: >>>>> ofbiz/tools/documentation/BuildBot/BuildBot.md >>>>> ofbiz/tools/wiki-files/BuildBot/BuildBot.md.html >>>>> >>>>> Modified: ofbiz/tools/documentation/BuildBot/BuildBot.md >>>>> URL: http://svn.apache.org/viewvc/ofbiz/tools/documentation/ >>>>> BuildBot/BuildBot.md?rev=1820671&r1=1820670&r2=1820671&view=diff >>>>> ============================================================ >>>>> ================== >>>>> --- ofbiz/tools/documentation/BuildBot/BuildBot.md (original) >>>>> +++ ofbiz/tools/documentation/BuildBot/BuildBot.md Tue Jan 9 15:20:58 >>>>> 2018 >>>>> @@ -23,6 +23,7 @@ BuilbBot documentation >>>>> OFBiz uses [BuilbBot](https://en.wikipedia.org/wiki/Buildbot) as >>>>> its >>>>> Continuous Integration (CI) tool. There are other CI tools [used >>>>> at the >>>>> ASF](https://ci.apache.org/). >>>>> >>>>> IMO the BuildBot pros and cons are >>>>> + >>>>> ### Pros >>>>> * Compared to a tool like Jenkins (those are the 2 I know) you >>>>> don't have >>>>> to use an UI, you write scripts. This is also a cons for some. >>>>> * The syntax is simple and well documented, some prefer >>>>> intuitive UI. >>>>> >>>>> Modified: ofbiz/tools/wiki-files/BuildBot/BuildBot.md.html >>>>> URL: http://svn.apache.org/viewvc/ofbiz/tools/wiki-files/ >>>>> BuildBot/BuildBot.md.html?rev=1820671&r1=1820670&r2=1820671&view=diff >>>>> ============================================================ >>>>> ================== >>>>> --- ofbiz/tools/wiki-files/BuildBot/BuildBot.md.html (original) >>>>> +++ ofbiz/tools/wiki-files/BuildBot/BuildBot.md.html Tue Jan 9 >>>>> 15:20:58 >>>>> 2018 >>>>> @@ -29,8 +29,15 @@ under the License. >>>>> <h1 id="builbbot-documentation">BuilbBot documentation</h1> >>>>> <h2 id="what-is-builbbot-and-why-using-it">What is BuilbBot and why >>>>> using it?</h2> >>>>> <p>OFBiz uses <a >>>>> href="https://en.wikipedia.org/wiki/Buildbot">BuilbBot</a> >>>>> as its Continuous Integration (CI) tool. There are other CI tools >>>>> <a href=" >>>>> https://ci.apache.org/">used at the ASF</a>.</p> >>>>> -<p>IMO the BuildBot pros and cons are ### Pros * Compared to a >>>>> tool like >>>>> Jenkins (those are the 2 I know) you don't have to use an UI, you >>>>> write >>>>> scripts. This is also a cons for some. * The syntax is simple and >>>>> well >>>>> documented, some prefer intuitive UI. * The infra team at the ASF >>>>> provides >>>>> a kind of compiler which prevents to commits error in the shared >>>>> script >>>>> (the builders are all common to the ASF)<br /> >>>>> -* The infra team, especially Gavin McDonald, is always ready to >>>>> help in a >>>>> very efficient way</p> >>>>> +<p>IMO the BuildBot pros and cons are</p> >>>>> +<h3 id="pros">Pros</h3> >>>>> +<ul> >>>>> +<li>Compared to a tool like Jenkins (those are the 2 I know) you >>>>> don't >>>>> have to use an UI, you write scripts. This is also a cons for >>>>> some.</li> >>>>> +<li>The syntax is simple and well documented, some prefer intuitive >>>>> UI.</li> >>>>> +<li>The infra team at the ASF provides a kind of compiler which >>>>> prevents >>>>> to commits error in the shared script (the builders are all common >>>>> to the >>>>> ASF)<br /> >>>>> +</li> >>>>> +<li>The infra team, especially Gavin McDonald, is always ready to >>>>> help in >>>>> a very efficient way</li> >>>>> +</ul> >>>>> <h3 id="cons">Cons</h3> >>>>> <ul> >>>>> <li>You have no UI so you have to write your own scripts, some >>>>> prefer UIs >>>>> to scripts.</li> >>>>> >>>>> >>>>> >>> >> >> > |
| Free forum by Nabble | Edit this page |