Wiki conversion update

[John Clingan]

MicroProfile MediaWiki -> Gitub Wiki
I've done some investigative work by marking a few MicroProfile wiki pages (of 122 total).  You can get a glimpse of it in a temporary testrepo project I set up. Note: Wiki pages are in stored using GitHub's flavor of Markdown. I used the EclipseWikiCrawler project to migrate a few pages. It doesn't quite work because of the folder issue (below), but I did write a 5 line script to fix the issue with the pages I am testing with.

The problem with GitHub wiki is that it is intended, IMHO, to be used as a wiki for a large site. It exists for documentation for relatively small projects. The reason is that using folders is not fully supported. A newly created wiki page using the browser is always stored in the top-level directory. Folders can be created with the git CLI since a GitHub wiki is more or less a GitHub project. I've read that a single-level folder hierarchy is supported, but I haven't tried it yet.

We are not heavy wiki users, so the above limitation may be acceptable. TBH, it is acceptable to me. I haven't checked if a git project can have separate permissions from its host project.

MicroProfile Wiki -> Hosted MediaWiki

I haven't investigated any Hosted MediaWiki options, but it is a likely option. 

MicroProfile Wiki -> WordPress
WordPress Wiki plugins are available. Unclear if we want to take this approach. Open to the idea.

[Emily Jiang]

Thank you John for your investigation! Your testrepo looks good to me. We can use this opportunity to remove some unused pages. I prefer Github wiki as all info finally ends up in one place. I have not used MediaWiki but I am not a big fan of WordPress. WordPress can make a good website but it also adds complexity. Github wiki is my vote.

Thanks

Emily

--
You received this message because you are subscribed to the Google Groups "MicroProfile" group.
To unsubscribe from this group and stop receiving emails from it, send an email to microprofile...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/microprofile/b38618d7-762a-47cf-887f-864a88e4785an%40googlegroups.com.

--

Thanks
Emily

[John Clingan]

Thanks Emily

[John Clingan]

Whups, I couple of points. I mean to say that GitHub wiki is *not* intended to be used for a large site.  Also, the "learning resources",  "Guidelines for Contributing", and "How to create a new repository" are the sub-pages that I have migrated.

[John Clingan]

OK, I've migrated the full MicroProfile wiki to a test repo. Check it out. There are some errors here and there, and some content that we probably want to update. I think we can do these in the MicroProfile GitHub Wiki.

[John Clingan]

Wiki migration to https://github.com/microprofile/microprofile-wg/wiki is live. There is some hopefully minor cleanup we'll have to do, but the heavy lifting is done.

[Emily Jiang]

Thanks, John! Looks great! I noticed the following 2 links are not working:

• Prepare for a final release
• How to perform a release

--
You received this message because you are subscribed to the Google Groups "MicroProfile" group.
To unsubscribe from this group and stop receiving emails from it, send an email to microprofile...@googlegroups.com.

To view this discussion on the web visit https://groups.google.com/d/msgid/microprofile/0037fe55-1145-4fd2-adfd-5802a53d2065n%40googlegroups.com.

--

Thanks
Emily

[John Clingan]

Fixed.

[Emily Jiang]

Awesome, thanks, John! Looks great! Just need to work out where the EF links go to. Maybe there are alternative github wiki pages for them as wll.

[John Clingan]

Based on yesterday's MicroProfile Technical call, I moved the wiki from the microprofile-wg repo to the eclipse/microprofile repo. We have a majority of our committers there.

[Emily Jiang]

Awesome, thanks John!