Cleaning up the wiki...

We appear to be getting more and more newcomers to the openEHR website and wiki - and on the wiki, they are faced with a somewhat chaotic place! I think we should slowly start to clean it up.

First suggestion:There are two spaces for developers - ‘Developers’, which has a lot of pages, and needs some re-organisation, and ‘Implementation Guidance’ which is small and not used much.

I propose to put the pages from the latter under the ‘Developers’ space and remove the latter space.

Second suggestion:I think we need a ‘getting started’ page for each manor development technology - Java, Python, C# etc. There are bits and pieces all over the place but nothing coherent.

Would people like to see something like the following structure:

  • Developers space
  • Getting started
  • Java
  • C#
  • Python
  • Ruby

thoughts?

  • thomas
(attachments)

oceanlogo.png
btnprofilebluetxt80x15.png

Agree with both. Probably we should go review the mailing lists to identify which kind of questions are usually asked by newcomers.

Also, we should use stackoverflow more, with dedicated tags to openEHR.

(attachments)

btnprofilebluetxt80x15.png
oceanlogo.png

+1 to all of these suggestions.

Ian

(attachments)

btnprofilebluetxt80x15.png
oceanlogo.png

Do we need to do anything special to make stackoverflow work? Should we treat that as a potential place to get specific Qs answered? We could certainly put some appropriate links from the website e.g. footer menu.. Stackoverflow has one of the best visual dynamics of all discussion list type forums, so I think it’s good to use it. - thomas

I don't think we need to do anything extra. Maybe we should encourage
the use of the tag (now some questions are wrongly tagged as HL7...)

http://stackoverflow.com/search?q=openehr

I created a - I’m not quite sure how this works, but I think if it gets visited by a lot of people, that helps it get created? So please visit the link! - thomas

Hi,

It also needs questions to move to the commit phase.

Is this tag also intended for questions related to implementations (java-libs) or just on abstract questions about the spec?

Best,

Duarte Ferreira

I would assume it can be both: a question could be just about specs
(just the "openEHR" tag) or about any specific implementation (e.g.
"openEHR" and "java")

yep - that's how I think it would work.

- thomas

One needs at least 1500 reputations to introduce a new tag (obviously openEHR doesn't exist yet).

Cheers,

-koray

Could questions be about modelling, or implementation/specs only?

Regards,
Silje

I think we need both.

Ian

Good luck Thomas, I hope this works and I have added my support, although there was a move recently to create an umbrella “Health IT” StackExchange and it didn’t attract enough support (despite being widely advertised) to trigger its promotion out of Area51 and into StackExchange.

If your openEHR StackExchange doesn’t get promoted however, there is an option to host your own StackExchangeClone site, I looked into this for a customer recently, one of the best clones is: https://github.com/ialbert/biostar-central

M

I've cleaned up the Developers space, made a half decent home page <https://openehr.atlassian.net/wiki/display/dev/Developers+Home&gt;, and moved the few pages from the Implementation Guidance space, which is now gone.

I leave it to others to work on this space - please try to be more active in keeping things up to date.

Next question: the Projects wiki space contains software development projects - should these pages also just go under the Developers space? If people agree with this idea I'll do it.

- thomas

Looking good so far :slight_smile:
I agree that projects wiki space can go under developers space.

Hello everyone

This is great news for openEHR but at the moment, the link between the specification and the implementation is not clear enough and the volume of questions might be low.

The majority of questions in the technical list up until 2013 were regarding modelling and specification changes / clarifications. There are many more technical questions, concerning implementation, lately that could attract questions on which option works better than others in a specific setting.

As a simplistic comparison, UML and modelling related questions are "lumped" under stack overflow currently.

I think that hosting our own "StackExchange" type of website might work better at this point.

By the way, I can add an "openEHR" tag to stack overflow if you think that would help things move forward (?)

All the best
Athanasios Anastasiou

I think so!

You can add tags to questions that are not yours? Probably the ideal
should be to have openEHR tags in all the already asked questions.

Hi Athanasios,

the content of the proposed openEHR StackExchange site is 'everything' openEHR - models, mapping, specifications, implementation. Anyway, let's see how it goes - currently there are 27 followers and a growing list of example questions. Maybe you can add some?

- thomas

Hello Thomas

Thanks, will have a go at adding something later on. Effectively, we are possibly looking at a "move" away from the mailing list here if the stack exchange site moves beyond definition.

All the best
Athanasios

I don't think so, because StackExchange is designed to deal with specific questions, not general discussions. You can't have a long running discussion on some general topic like 'modelling patterns' on StackExchange.

I think that these lists might one day migrate into a more modern type of tool like Discourse, which I have been looking at.

- thomas