You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@felix.apache.org by Georg Henzler <fe...@ghenzler.de> on 2019/01/28 08:50:28 UTC
Documentation for Apache Felix Health Checks
Hi all,
while creating the first release I found another solution for the
problem described in [2] - but when comparing to [1] (that looks like
it's the source of it), it does not seem to be consistent (in the wiki
[1] there is an Appendix C while the web page [2] does not have that).
I'm not sure about the publication process here. Also I would like to
move the documentation in the markdown file [3] to the correct location
which I believe is a sub page "Apache Felix Health Checks" underneath
[4], but there I do not have access rights yet. What's the process for
it? Could somebody from the PMC please grant me access to the wiki?
Thanks & Best Regards
Georg
[1]
https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=115457
[2]
http://felix.apache.org/documentation/development/release-management-nexus.html#appendix-b-preparing-releases-on-mac-os-x
[3]
http://svn.apache.org/viewvc/felix/trunk/healthcheck/docs/felix-health-checks.md?view=log&pathrev=1849246
[4] https://cwiki.apache.org/confluence/display/FELIX/Subprojects
Re: Documentation for Apache Felix Health Checks
Posted by Georg Henzler <fe...@ghenzler.de>.
Hi,
I eventually got around to fix up the documentation [1].
Feedback is welcome - I'm not sure if I did everything right.
Best Regards
Georg
[1]
https://github.com/apache/felix/blob/trunk/healthcheck/README.md
http://felix.apache.org/documentation/subprojects/apache-felix-healthchecks.html
<-- stub page linking to README above
http://felix.apache.org/documentation/subprojects.html
http://felix.apache.org/#apache-felix-subprojects
http://felix.apache.org/news.html
On 2019-02-13 05:24, Georg Henzler wrote:
> I like that approach as well, if there is no objections I'll do it like
> that.
>
> -Georg
>
> On 2019-02-12 07:07, Christian Schneider wrote:
>> +1 for using markup files in github for documentation.
>> It is a bit inconvenient as long as we are not on git natively .. but
>> I
>> hope this soon changes.
>>
>> Christian
>>
>> Am Di., 12. Feb. 2019 um 14:00 Uhr schrieb Bertrand Delacretaz <
>> bdelacretaz@apache.org>:
>>
>>> Hi Georg,
>>>
>>> On Mon, Jan 28, 2019 at 12:50 AM Georg Henzler <fe...@ghenzler.de>
>>> wrote:
>>> > ...I would like to
>>> > move the documentation in the markdown file [3] to the correct location
>>> > which I believe is a sub page "Apache Felix Health Checks" underneath
>>> > [4],...
>>>
>>> Many projects today just use those Markdown files in GitHub for docs,
>>> the advantage IMO is that they stay with the code which can make it
>>> easier to remember to keep them up to date.
>>>
>>> If the Felix PMC agrees with that I would suggest just listing the
>>> new
>>> Health Checks modules at [4], pointing to the
>>> https://github.com/apache/felix/tree/trunk/healthcheck mirror and
>>> moving [3] so that it becomes the README of that path - as it's the
>>> general documentation for that group of modules.
>>>
>>> -Bertrand
>>>
>>> > [3]
>>> >
>>> http://svn.apache.org/viewvc/felix/trunk/healthcheck/docs/felix-health-checks.md?view=log&pathrev=1849246
>>> > [4] https://cwiki.apache.org/confluence/display/FELIX/Subprojects
>>>
>>
>>
>> --
Re: Documentation for Apache Felix Health Checks
Posted by Georg Henzler <fe...@ghenzler.de>.
I like that approach as well, if there is no objections I'll do it like
that.
-Georg
On 2019-02-12 07:07, Christian Schneider wrote:
> +1 for using markup files in github for documentation.
> It is a bit inconvenient as long as we are not on git natively .. but I
> hope this soon changes.
>
> Christian
>
> Am Di., 12. Feb. 2019 um 14:00 Uhr schrieb Bertrand Delacretaz <
> bdelacretaz@apache.org>:
>
>> Hi Georg,
>>
>> On Mon, Jan 28, 2019 at 12:50 AM Georg Henzler <fe...@ghenzler.de>
>> wrote:
>> > ...I would like to
>> > move the documentation in the markdown file [3] to the correct location
>> > which I believe is a sub page "Apache Felix Health Checks" underneath
>> > [4],...
>>
>> Many projects today just use those Markdown files in GitHub for docs,
>> the advantage IMO is that they stay with the code which can make it
>> easier to remember to keep them up to date.
>>
>> If the Felix PMC agrees with that I would suggest just listing the new
>> Health Checks modules at [4], pointing to the
>> https://github.com/apache/felix/tree/trunk/healthcheck mirror and
>> moving [3] so that it becomes the README of that path - as it's the
>> general documentation for that group of modules.
>>
>> -Bertrand
>>
>> > [3]
>> >
>> http://svn.apache.org/viewvc/felix/trunk/healthcheck/docs/felix-health-checks.md?view=log&pathrev=1849246
>> > [4] https://cwiki.apache.org/confluence/display/FELIX/Subprojects
>>
>
>
> --
Re: Documentation for Apache Felix Health Checks
Posted by Christian Schneider <ch...@die-schneider.net>.
+1 for using markup files in github for documentation.
It is a bit inconvenient as long as we are not on git natively .. but I
hope this soon changes.
Christian
Am Di., 12. Feb. 2019 um 14:00 Uhr schrieb Bertrand Delacretaz <
bdelacretaz@apache.org>:
> Hi Georg,
>
> On Mon, Jan 28, 2019 at 12:50 AM Georg Henzler <fe...@ghenzler.de> wrote:
> > ...I would like to
> > move the documentation in the markdown file [3] to the correct location
> > which I believe is a sub page "Apache Felix Health Checks" underneath
> > [4],...
>
> Many projects today just use those Markdown files in GitHub for docs,
> the advantage IMO is that they stay with the code which can make it
> easier to remember to keep them up to date.
>
> If the Felix PMC agrees with that I would suggest just listing the new
> Health Checks modules at [4], pointing to the
> https://github.com/apache/felix/tree/trunk/healthcheck mirror and
> moving [3] so that it becomes the README of that path - as it's the
> general documentation for that group of modules.
>
> -Bertrand
>
> > [3]
> >
> http://svn.apache.org/viewvc/felix/trunk/healthcheck/docs/felix-health-checks.md?view=log&pathrev=1849246
> > [4] https://cwiki.apache.org/confluence/display/FELIX/Subprojects
>
--
--
Christian Schneider
http://www.liquid-reality.de
Computer Scientist
http://www.adobe.com
Re: Documentation for Apache Felix Health Checks
Posted by Bertrand Delacretaz <bd...@apache.org>.
Hi Georg,
On Mon, Jan 28, 2019 at 12:50 AM Georg Henzler <fe...@ghenzler.de> wrote:
> ...I would like to
> move the documentation in the markdown file [3] to the correct location
> which I believe is a sub page "Apache Felix Health Checks" underneath
> [4],...
Many projects today just use those Markdown files in GitHub for docs,
the advantage IMO is that they stay with the code which can make it
easier to remember to keep them up to date.
If the Felix PMC agrees with that I would suggest just listing the new
Health Checks modules at [4], pointing to the
https://github.com/apache/felix/tree/trunk/healthcheck mirror and
moving [3] so that it becomes the README of that path - as it's the
general documentation for that group of modules.
-Bertrand
> [3]
> http://svn.apache.org/viewvc/felix/trunk/healthcheck/docs/felix-health-checks.md?view=log&pathrev=1849246
> [4] https://cwiki.apache.org/confluence/display/FELIX/Subprojects