+1 for adoc

That was my plan for Pax Web 8 too:
https://github.com/ops4j/org.ops4j.pax.web/blob/main/todo.txt#L37 - see,
still not `+`...
There's even (quite untouched since I started) skeleton of
https://github.com/ops4j/org.ops4j.pax.web/blob/main/pax-web-manual/src/docs/asciidoc/pax-web-dev-guide.adoc
and prepared asciidoctor-maven-plugin configuration:
https://github.com/ops4j/org.ops4j.pax.web/blob/main/pax-web-manual/pom.xml#L52

But ... I didn't have time to document everything. Definitely it's still in
my plans thought.

kind regards
Grzegorz Grzybek

wt., 18 kwi 2023 o 18:29 Matt Pavlovich <matt.pavlov...@hyte.io> napisał(a):

> +1 I like the idea of asciidoc and then having GitHub host the docs using
> GH Pages.
>
>
>
> *From: *ops4j@googlegroups.com <ops4j@googlegroups.com> on behalf of
> Łukasz Dywicki <l...@code-house.org>
> *Date: *Tuesday, April 18, 2023 at 11:23 AM
> *To: *OPS4J <ops4j@googlegroups.com>
> *Subject: *Re: Should we move from Confluence to Github Wiki?
>
> Which confluence contents are we talking about?
>
>
>
> Online tools are great, but I'd say the less we depend on them for
> documentation related areas, the better it is. Changes in pax web and
> transition to asciidoc was very valuable step. Ideally each "alive" ops4j
> project could do it. Do we have other repositories which require similar
> migration?
>
>
>
> Best,
>
> Łukasz
>
>
>
> wtorek, 18 kwietnia 2023 o 13:09:34 UTC+2 gr.gr...@gmail.com napisał(a):
>
> Looks good - formatting is nice and it's much easier now to review it and
> update ;)
>
>
>
> regards
>
> Grzegorz Grzybek
>
>
>
> wt., 18 kwi 2023 o 12:31 sasch...@gmail.com <sasch...@gmail.com>
> napisał(a):
>
> I've created a sample for pax-exam (no tweaking done, just running a
> converter script): https://github.com/svogt/org.ops4j.pax.exam2/wiki
>
> sasch...@gmail.com schrieb am Dienstag, 18. April 2023 um 11:19:15 UTC+2:
>
> Hi,
>
> gr...@gmail.com schrieb am Dienstag, 18. April 2023 um 10:30:42 UTC+2:
>
> When refactoring Pax Web I had plans to create proper gh-pages branch with
> deployable wiki/gh page. But you know how it is...
>
> I never thought about direct migration of existing Confluence pages,
> because (that's my habit) I'd get stuck rewriting every page (they are in
> large part outdated...).
>
> Well I would (as a first start) migrate everything as is (if it's
> automatic I can keep my OCD in place by just not looking at every page ;) )
> - then (if it's the GH wiki) one can change it afterwards easily as one
> sees fit.
>
>
>
> I'm not sure if "wiki" is enabled on GH sites for OPS4J pages - I can
> enable it if needed, but to be honest I don't have free cycles to work on
> it...
>
> Yeah, I would try it out on one space and if the automatic script works
> well (enough) we could just go ahead and push it...
>
>
>
> Anyway, big +1 for the idea ;)
>
> Thanks ;)
>
> --
>
> --
> ------------------
> OPS4J - http://www.ops4j.org - op...@googlegroups.com
>
> ---
> You received this message because you are subscribed to the Google Groups
> "OPS4J" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to ops4j+un...@googlegroups.com.
>
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/ops4j/c7d80faf-2e80-4f49-9501-a753f3f1b926n%40googlegroups.com
> <https://groups.google.com/d/msgid/ops4j/c7d80faf-2e80-4f49-9501-a753f3f1b926n%40googlegroups.com?utm_medium=email&utm_source=footer>
> .
>
> --
> --
> ------------------
> OPS4J - http://www.ops4j.org - ops4j@googlegroups.com
>
> ---
> You received this message because you are subscribed to the Google Groups
> "OPS4J" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to ops4j+unsubscr...@googlegroups.com.
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/ops4j/52f26d0d-448a-4b87-8400-c76ddfd3589fn%40googlegroups.com
> <https://groups.google.com/d/msgid/ops4j/52f26d0d-448a-4b87-8400-c76ddfd3589fn%40googlegroups.com?utm_medium=email&utm_source=footer>
> .
>
> --
> --
> ------------------
> OPS4J - http://www.ops4j.org - ops4j@googlegroups.com
>
> ---
> You received this message because you are subscribed to the Google Groups
> "OPS4J" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to ops4j+unsubscr...@googlegroups.com.
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/ops4j/SA1PR12MB7319B53F92FCA16AE7DB3C31809D9%40SA1PR12MB7319.namprd12.prod.outlook.com
> <https://groups.google.com/d/msgid/ops4j/SA1PR12MB7319B53F92FCA16AE7DB3C31809D9%40SA1PR12MB7319.namprd12.prod.outlook.com?utm_medium=email&utm_source=footer>
> .
>

-- 
-- 
------------------
OPS4J - http://www.ops4j.org - ops4j@googlegroups.com

--- 
You received this message because you are subscribed to the Google Groups 
"OPS4J" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to ops4j+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/ops4j/CAAdXmhq3-m0tM9o7EE2Dxf7THvu8N04HML7kfeNMc2P_XPA2ow%40mail.gmail.com.

Reply via email to