From SMW+ Semantic Enterprise Wiki

Jump to: navigation, search

	Getting involved
	user manual article for SMWforum User Manuals Section 0.9

By: Dominika

Administrator, End user, Gardener, Ontologist

User contributions add to the quality of the user forum. Your contributions are therefore desired and profoundly appreciated. Kindly try to be one of the contributors.

User manual information
Applies to release(s):
SMWforum User Manuals Section 0.9
Note: use the tree-view on the right hand side to navigate in the user manuals.

How to become a registered user

One may actually read articles in this forum without having an account.

We however recommend that you become a registered user since you thereby gain access to several features:

other users may contact you and even see the contributions that you have made,
write own articles (e.g. examples in the library) and correct issues in articles,
file bugs which you have found in your SMW+/SMW installation

Follow this help-article to read How to create an account in the SMW+ User Forum .

(you can read more about the user roles: Take a look at the defined roles)

Leaving general feedback

We appreciate any form of feedback since this helps us to improve our services and our communication in general; you can basically comment on articles, start a discussion or drop us an email:

Note:

The ontoprise team (and the community) is checking the SMWforum for your feedback on an irregular basis; we cannot guarantee for a timely reply.

Leaving feedback about SMW⁺ or the halo Extension

Let us know how useful you find our products and what is required to make it more suitable for you. Tell us about bugs you found in the software:

Open the "Using SMW+, SMW and the Halo Extension in daily work" section in the discussion forum and let the community know about your experiences.
If you believe you found a software bug in SMW⁺ or the halo extension then file a software bug in SMWbugzilla.
Read How to file a bug .
You want to propose a new feature? Then file a feature request in SMWbugzilla.
Read How to propose a feature request .

Reporting wrong or missing information in articles

If you found an error in a manual article or if you miss accuracy in a particular article which you don't want to correct by yourself, then please file a quality issue for the given article in SMWbugzilla. You can simply point out the error, suggest an update or make a proposal for a new topic.

Report a quality issue in SMWforum.
How to report a bug in SMWbugzilla .
See the list of current quality issues filed for SMWforum: list of quality issues.
Read the quality assurance process in SMWforum: How to assure the quality of manual articles

Authoring articles in this wiki

Whenever you seek help from the user manuals and get stuck just start taking notes at this point. Once you find the solution, kindly try and help other users by documenting your experience and your work-around. Try and present your solution to other users so that you save them the hustle of falling into the same problematic. You can actually improve the user manual directly or create a task for the documentation team. Here are some ways in which you may help make the manuals better:

By editing the pages directly by clicking on the "Edit" tab. Don't mind so much about the mistakes that you fear that you might make. We have a mechanism that keeps revisions of all manual pages such that we may at all times recover the previous version if need be.
Read How to edit an article .
By adding a comment on manual articles. We recommend that one logs in while posting comments since this is much more personal. Nonetheless, one might do this without logging in. This will however only display your IP address.
By adding new manual pages. All registered users can add new pages. If you have the knowledge about a stable extension that requires user documentation, kindly let the community know about this. You simply need to provide the name of the extension in the box that is located below followed by filling-in the form. You, or in possible collaboration with other users, can then start documenting this software product. If you are of the opinion that some pages or details about a certain topic are missing, always feel free to submit a task which should have the type "propose new article."

More information

Here are some resources that you might find helpful when authoring articles in the SMWforum:

Read the guidelines for adding new content or changing existing content
Read documentation about the user manuals section for a general overview of the User Manual Section.
Editing an article
Create a new page
Creating a help page
Improving the SMW+ User Forum

Supporting other users

Kindly help answer the other user’s questions where possible. To do this:

see latest threads and comments in the Community main page
Try to answer them by replying to the comments or posting in the discussion board.

Be part of the software development process

add a comment

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the article "GNU Free Documentation License".