You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@freemarker.apache.org by Daniel Dekany <dd...@freemail.hu> on 2017/01/05 00:32:37 UTC
Comitter how-to page, step-by-step instructions for making releases
I did and bravely published a page to help future Committers (by which
I mean people who can commit directly into the Apache repo, and
certainly can do releases too). It's mostly to help in technical
things, such as it describes how to make a FreeMarker release. But
there's some project policies there too. Please take look, tell me
what to change, what to add:
http://freemarker.org/committer-howto.html
If anyone wants to edit it, it's here:
https://git-wip-us.apache.org/repos/asf/incubator-freemarker-site.git.
GitHub mirror: https://github.com/apache/incubator-freemarker-site.
Branch: master
File: src/main/docgen/book.xml
--
Thanks,
Daniel Dekany
Re: Comitter how-to page, step-by-step instructions for making releases
Posted by Daniel Dekany <dd...@freemail.hu>.
Thursday, January 5, 2017, 8:42:05 AM, Jacopo Cappellato wrote:
> Thank you Daniel.
> I hope I didn't mess the line wrapping... please let me know if there is a
> best practice for this.
No big deal, it's just that it generates unwanted diff when I commit
some other change later, as XXE always reformats the whole XML. We
recommended using XXE for the editing (as described in
src/manual/en_US/docgen-help/editors-readme.txt). This, by default
does hard wrapping with max line width of 78. Perhaps we should just
use no hard wrapping. Will try how well Git handles long lines. (The
problem back then was that even if you have only changed one letter,
the diff has shown the whole line as changed, which wasn't very
helpful for long paragraphs and no hard wrapping. Sure enough, if your
change caused re-wrapping, you weren't better of.)
> Jacopo
>
> On Thu, Jan 5, 2017 at 8:39 AM, Daniel Dekany <dd...@freemail.hu> wrote:
>
>> Merged and published, thanks!
>>
>>
>> Thursday, January 5, 2017, 8:08:18 AM, Jacopo Cappellato wrote:
>>
>> > Pull request created.
>> >
>> > Jacopo
>> >
>> > On Thu, Jan 5, 2017 at 7:13 AM, Jacopo Cappellato <
>> > jacopo.cappellato@gmail.com> wrote:
>> >
>> >> On Thu, Jan 5, 2017 at 1:32 AM, Daniel Dekany <dd...@freemail.hu>
>> wrote:
>> >>
>> >>> I did and bravely published a page to help future Committers (by which
>> >>> I mean people who can commit directly into the Apache repo, and
>> >>> certainly can do releases too). It's mostly to help in technical
>> >>> things, such as it describes how to make a FreeMarker release. But
>> >>> there's some project policies there too. Please take look, tell me
>> >>> what to change, what to add:
>> >>>
>> >>> http://freemarker.org/committer-howto.html
>> >>>
>> >>> If anyone wants to edit it, it's here:
>> >>> https://git-wip-us.apache.org/repos/asf/incubator-freemarker-site.git.
>> >>> GitHub mirror: https://github.com/apache/incubator-freemarker-site.
>> >>> Branch: master
>> >>> File: src/main/docgen/book.xml
>> >>>
>> >>> --
>> >>> Thanks,
>> >>> Daniel Dekany
>> >>>
>> >>>
>> >> Daniel, thank you for writing it down, it is a great resource and I wish
>> >> all other Apache projects had similar ones: it would make life easier to
>> >> new committers and release managers.
>> >> I may have some minor editing (that I will submit as a GitHub pull
>> >> request) but it would be great if others in this community may review it
>> >> and provide their feedback, proof read it etc...
>> >>
>> >> Jacopo
>> >>
>>
>> --
>> Thanks,
>> Daniel Dekany
>>
>>
--
Thanks,
Daniel Dekany
Re: Comitter how-to page, step-by-step instructions for making releases
Posted by Jacopo Cappellato <ja...@gmail.com>.
Thank you Daniel.
I hope I didn't mess the line wrapping... please let me know if there is a
best practice for this.
Jacopo
On Thu, Jan 5, 2017 at 8:39 AM, Daniel Dekany <dd...@freemail.hu> wrote:
> Merged and published, thanks!
>
>
> Thursday, January 5, 2017, 8:08:18 AM, Jacopo Cappellato wrote:
>
> > Pull request created.
> >
> > Jacopo
> >
> > On Thu, Jan 5, 2017 at 7:13 AM, Jacopo Cappellato <
> > jacopo.cappellato@gmail.com> wrote:
> >
> >> On Thu, Jan 5, 2017 at 1:32 AM, Daniel Dekany <dd...@freemail.hu>
> wrote:
> >>
> >>> I did and bravely published a page to help future Committers (by which
> >>> I mean people who can commit directly into the Apache repo, and
> >>> certainly can do releases too). It's mostly to help in technical
> >>> things, such as it describes how to make a FreeMarker release. But
> >>> there's some project policies there too. Please take look, tell me
> >>> what to change, what to add:
> >>>
> >>> http://freemarker.org/committer-howto.html
> >>>
> >>> If anyone wants to edit it, it's here:
> >>> https://git-wip-us.apache.org/repos/asf/incubator-freemarker-site.git.
> >>> GitHub mirror: https://github.com/apache/incubator-freemarker-site.
> >>> Branch: master
> >>> File: src/main/docgen/book.xml
> >>>
> >>> --
> >>> Thanks,
> >>> Daniel Dekany
> >>>
> >>>
> >> Daniel, thank you for writing it down, it is a great resource and I wish
> >> all other Apache projects had similar ones: it would make life easier to
> >> new committers and release managers.
> >> I may have some minor editing (that I will submit as a GitHub pull
> >> request) but it would be great if others in this community may review it
> >> and provide their feedback, proof read it etc...
> >>
> >> Jacopo
> >>
>
> --
> Thanks,
> Daniel Dekany
>
>
Re: Comitter how-to page, step-by-step instructions for making releases
Posted by Daniel Dekany <dd...@freemail.hu>.
Merged and published, thanks!
Thursday, January 5, 2017, 8:08:18 AM, Jacopo Cappellato wrote:
> Pull request created.
>
> Jacopo
>
> On Thu, Jan 5, 2017 at 7:13 AM, Jacopo Cappellato <
> jacopo.cappellato@gmail.com> wrote:
>
>> On Thu, Jan 5, 2017 at 1:32 AM, Daniel Dekany <dd...@freemail.hu> wrote:
>>
>>> I did and bravely published a page to help future Committers (by which
>>> I mean people who can commit directly into the Apache repo, and
>>> certainly can do releases too). It's mostly to help in technical
>>> things, such as it describes how to make a FreeMarker release. But
>>> there's some project policies there too. Please take look, tell me
>>> what to change, what to add:
>>>
>>> http://freemarker.org/committer-howto.html
>>>
>>> If anyone wants to edit it, it's here:
>>> https://git-wip-us.apache.org/repos/asf/incubator-freemarker-site.git.
>>> GitHub mirror: https://github.com/apache/incubator-freemarker-site.
>>> Branch: master
>>> File: src/main/docgen/book.xml
>>>
>>> --
>>> Thanks,
>>> Daniel Dekany
>>>
>>>
>> Daniel, thank you for writing it down, it is a great resource and I wish
>> all other Apache projects had similar ones: it would make life easier to
>> new committers and release managers.
>> I may have some minor editing (that I will submit as a GitHub pull
>> request) but it would be great if others in this community may review it
>> and provide their feedback, proof read it etc...
>>
>> Jacopo
>>
--
Thanks,
Daniel Dekany
Re: Comitter how-to page, step-by-step instructions for making releases
Posted by Jacopo Cappellato <ja...@gmail.com>.
Pull request created.
Jacopo
On Thu, Jan 5, 2017 at 7:13 AM, Jacopo Cappellato <
jacopo.cappellato@gmail.com> wrote:
> On Thu, Jan 5, 2017 at 1:32 AM, Daniel Dekany <dd...@freemail.hu> wrote:
>
>> I did and bravely published a page to help future Committers (by which
>> I mean people who can commit directly into the Apache repo, and
>> certainly can do releases too). It's mostly to help in technical
>> things, such as it describes how to make a FreeMarker release. But
>> there's some project policies there too. Please take look, tell me
>> what to change, what to add:
>>
>> http://freemarker.org/committer-howto.html
>>
>> If anyone wants to edit it, it's here:
>> https://git-wip-us.apache.org/repos/asf/incubator-freemarker-site.git.
>> GitHub mirror: https://github.com/apache/incubator-freemarker-site.
>> Branch: master
>> File: src/main/docgen/book.xml
>>
>> --
>> Thanks,
>> Daniel Dekany
>>
>>
> Daniel, thank you for writing it down, it is a great resource and I wish
> all other Apache projects had similar ones: it would make life easier to
> new committers and release managers.
> I may have some minor editing (that I will submit as a GitHub pull
> request) but it would be great if others in this community may review it
> and provide their feedback, proof read it etc...
>
> Jacopo
>
Re: Comitter how-to page, step-by-step instructions for making releases
Posted by Jacopo Cappellato <ja...@gmail.com>.
On Thu, Jan 5, 2017 at 1:32 AM, Daniel Dekany <dd...@freemail.hu> wrote:
> I did and bravely published a page to help future Committers (by which
> I mean people who can commit directly into the Apache repo, and
> certainly can do releases too). It's mostly to help in technical
> things, such as it describes how to make a FreeMarker release. But
> there's some project policies there too. Please take look, tell me
> what to change, what to add:
>
> http://freemarker.org/committer-howto.html
>
> If anyone wants to edit it, it's here:
> https://git-wip-us.apache.org/repos/asf/incubator-freemarker-site.git.
> GitHub mirror: https://github.com/apache/incubator-freemarker-site.
> Branch: master
> File: src/main/docgen/book.xml
>
> --
> Thanks,
> Daniel Dekany
>
>
Daniel, thank you for writing it down, it is a great resource and I wish
all other Apache projects had similar ones: it would make life easier to
new committers and release managers.
I may have some minor editing (that I will submit as a GitHub pull request)
but it would be great if others in this community may review it and provide
their feedback, proof read it etc...
Jacopo
Re: Comitter how-to page, step-by-step instructions for making releases
Posted by Daniel Dekany <dd...@freemail.hu>.
Thanks, published. (I can do the asf-site part quickly, no problem.)
Thursday, January 5, 2017, 5:40:29 PM, Jacopo Cappellato wrote:
> They looks great to me, thank you!
> I have created a small pull request to fix a couple of typos; I didn't
> generate the html files and commit them to the asf-site branch yet because
> these minor fixes can be published at a later point with some other major
> edits (please let me know if you want e to create a new pull request for
> asf-site).
>
> Jacopo
>
> On Thu, Jan 5, 2017 at 11:40 AM, Daniel Dekany <dd...@freemail.hu> wrote:
>
>> I have added some more sections (and a page Toc) to
>> http://freemarker.org/committer-howto.html since then.
>>
>> I have also added a short preface to
>> http://freemarker.org/contribute.html; you might want to check it.
>>
>>
>> Thursday, January 5, 2017, 1:32:37 AM, Daniel Dekany wrote:
>>
>> > I did and bravely published a page to help future Committers (by which
>> > I mean people who can commit directly into the Apache repo, and
>> > certainly can do releases too). It's mostly to help in technical
>> > things, such as it describes how to make a FreeMarker release. But
>> > there's some project policies there too. Please take look, tell me
>> > what to change, what to add:
>> >
>> > http://freemarker.org/committer-howto.html
>> >
>> > If anyone wants to edit it, it's here:
>> > https://git-wip-us.apache.org/repos/asf/incubator-freemarker-site.git.
>> > GitHub mirror: https://github.com/apache/incubator-freemarker-site.
>> > Branch: master
>> > File: src/main/docgen/book.xml
>> >
>>
>> --
>> Thanks,
>> Daniel Dekany
>>
>>
--
Thanks,
Daniel Dekany
Re: Comitter how-to page, step-by-step instructions for making releases
Posted by Jacopo Cappellato <ja...@gmail.com>.
They looks great to me, thank you!
I have created a small pull request to fix a couple of typos; I didn't
generate the html files and commit them to the asf-site branch yet because
these minor fixes can be published at a later point with some other major
edits (please let me know if you want e to create a new pull request for
asf-site).
Jacopo
On Thu, Jan 5, 2017 at 11:40 AM, Daniel Dekany <dd...@freemail.hu> wrote:
> I have added some more sections (and a page Toc) to
> http://freemarker.org/committer-howto.html since then.
>
> I have also added a short preface to
> http://freemarker.org/contribute.html; you might want to check it.
>
>
> Thursday, January 5, 2017, 1:32:37 AM, Daniel Dekany wrote:
>
> > I did and bravely published a page to help future Committers (by which
> > I mean people who can commit directly into the Apache repo, and
> > certainly can do releases too). It's mostly to help in technical
> > things, such as it describes how to make a FreeMarker release. But
> > there's some project policies there too. Please take look, tell me
> > what to change, what to add:
> >
> > http://freemarker.org/committer-howto.html
> >
> > If anyone wants to edit it, it's here:
> > https://git-wip-us.apache.org/repos/asf/incubator-freemarker-site.git.
> > GitHub mirror: https://github.com/apache/incubator-freemarker-site.
> > Branch: master
> > File: src/main/docgen/book.xml
> >
>
> --
> Thanks,
> Daniel Dekany
>
>
Re: Comitter how-to page, step-by-step instructions for making releases
Posted by Daniel Dekany <dd...@freemail.hu>.
I have added some more sections (and a page Toc) to
http://freemarker.org/committer-howto.html since then.
I have also added a short preface to
http://freemarker.org/contribute.html; you might want to check it.
Thursday, January 5, 2017, 1:32:37 AM, Daniel Dekany wrote:
> I did and bravely published a page to help future Committers (by which
> I mean people who can commit directly into the Apache repo, and
> certainly can do releases too). It's mostly to help in technical
> things, such as it describes how to make a FreeMarker release. But
> there's some project policies there too. Please take look, tell me
> what to change, what to add:
>
> http://freemarker.org/committer-howto.html
>
> If anyone wants to edit it, it's here:
> https://git-wip-us.apache.org/repos/asf/incubator-freemarker-site.git.
> GitHub mirror: https://github.com/apache/incubator-freemarker-site.
> Branch: master
> File: src/main/docgen/book.xml
>
--
Thanks,
Daniel Dekany