Should we move from Confluence to Github Wiki?

[sasch...@gmail.com]

Hi all,

as we switched to Github Issues a while ago (thanks again Grzegorz), I was wondering about the Wikis (Confluence based at the moment). Should those be migrated over as well to have everything in one place?

Does anyone have any experience about migrating the pages? 

Greetings

.sascha

[Grzegorz Grzybek]

Hello

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...).

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...

Anyway, big +1 for the idea ;)

regards

Grzegorz Grzybek

--
--
------------------
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/6e6d31d1-97fb-4f7a-826b-ea9e1f3c21c5n%40googlegroups.com.

[sasch...@gmail.com]

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 ;) 

[sasch...@gmail.com]

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 

[Grzegorz Grzybek]

Looks good - formatting is nice and it's much easier now to review it and update ;)

regards

Grzegorz Grzybek

--

--
------------------
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.

[Łukasz Dywicki]

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

[Matt Pavlovich]

+1 I like the idea of asciidoc and then having GitHub host the docs using GH Pages.

To view this discussion on the web visit https://groups.google.com/d/msgid/ops4j/52f26d0d-448a-4b87-8400-c76ddfd3589fn%40googlegroups.com.

[Grzegorz Grzybek]

+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

To view this discussion on the web visit https://groups.google.com/d/msgid/ops4j/SA1PR12MB7319B53F92FCA16AE7DB3C31809D9%40SA1PR12MB7319.namprd12.prod.outlook.com.