Re: Should we move from Confluence to Github Wiki?

[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

wt., 18 kwi 2023 o 18:29 Matt Pavlovich  napisał(a):

> +1 I like the idea of asciidoc and then having GitHub host the docs using
> GH Pages.
>
>
>
> *From: *ops4j@googlegroups.com  on behalf of
> Łukasz Dywicki 
> *Date: *Tuesday, April 18, 2023 at 11:23 AM
> *To: *OPS4J 
> *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 
> 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_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_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.p

Re: Should we move from Confluence to Github Wiki?

[Matt Pavlovich]

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

From: ops4j@googlegroups.com  on behalf of Łukasz 
Dywicki 
Date: Tuesday, April 18, 2023 at 11:23 AM
To: OPS4J 
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  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_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<mailto: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_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.

Re: Should we move from Confluence to Github Wiki?

[Ł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

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

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

Re: Should we move from Confluence to Github Wiki?

[Grzegorz Grzybek]

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 
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 - 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/c7d80faf-2e80-4f49-9501-a753f3f1b926n%40googlegroups.com
> 
> .
>

-- 
-- 
--
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/CAAdXmhqgd5onEyNNbmRhMtDRGpZ-eRNG4%3DeT%2B%2BU0aTpo6aPyBA%40mail.gmail.com.

Re: Should we move from Confluence to Github Wiki?

[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 

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 - 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/c7d80faf-2e80-4f49-9501-a753f3f1b926n%40googlegroups.com.

Re: Should we move from Confluence to Github Wiki?

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

-- 
-- 
--
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/ef94ecb6-1939-4658-8a7d-15099d2261cbn%40googlegroups.com.

Re: Should we move from Confluence to Github Wiki?

[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

wt., 18 kwi 2023 o 10:16 sasch...@gmail.com 
napisał(a):

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

-- 
-- 
--
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/CAAdXmhpsoRXwDRaPuG21dLmomhY_i6-VjVo1tsH5CrUshbBUtA%40mail.gmail.com.

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

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