User forum

From AtoM wiki
Revision as of 14:02, 18 August 2016 by Dan (talk | contribs) (Tagging your support post: Make section title a hyperlink)

Main Page > Resources > Resources/User forum

This page includes some basic information on the AtoM User Forum, Artefactual's support policy for the Forum, our Code of Conduct, and some suggestions for information to include when making a support post, so we can get back to you with useful answers.

What is the AtoM User Forum?

The AtoM User Forum is the main place where users come to seek help, make announcements, share resources, and discuss issues relevant to the software and the community. Whether looking to troubleshoot an issue, share some good news, connect with other users, or ask a question, the User Forum is the best place to get interactive feedback from other AtoM users and developers.

Artefactual, the lead developers of AtoM, moderates the user forum, and we try whenever possible to post responses to straight-forward user questions within 48 hours of their posting (during M-F business hours - we are in the Pacific time zone). See below for further details on our support policy.

Who can post in the forum?

Anyone can! There is no cost, no membership requirement, and no restrictions on participation. All you need is an email address and an interest in AtoM. The forum is open to both amateurs and experts; archivists, system administrators, and developers - and more!

Is the forum just for technical support?

No! Though many people post in our forum looking to troubleshoot an issue, we encourage users to share success stories, strategies, resources, workarounds for known issues, and thoughts related the cultural heritage community. Let us know about AtoM-related events in your area; help spread the word about a new AtoM site; make plans connect with other AtoM users at upcoming conferences and events; talk about your ideal workflow and features you'd like to see in a future release. The forum is only as interesting as you help to make it!

What is Artefactual's policy on support in the forum?

We are happy to freely provide support to straightforward issues as we are able. In general, if you have a support question, Artefactual will try to post an initial response with some suggestions within the first 48 hours. Remember, we are available Monday-Friday, 9am-5pm Pacific, so if your question is posted at the end of the week, we might not get back to you until the following Monday.

This is a freely offered service we provide as we are able, and we hope to see more community users become active over time in answering each others' questions. When we think a particular query is beyond these free support parameters we will inform the user that it may be necessary to address it as paid, commercial support. Examples include questions that are too in-depth and time-consuming to investigate and answer or questions that involve unsupported tools or platforms. Please keep in mind that we have to prioritize our client assignments so that we can pay our bills and continue to provide free software and free community support.

Tip

If you are interested in commercial support from Artefactual, please see our website for the services we offer.

Please be patient, and always be respectful. If for some reason we have not responded to your question within the initial 48 hour period, please do not repost your question as a new Topic. If you don't receive a response to your question within a week, then it is appropriate to "bump" your Topic by adding a new message in the thread. Thanks!

Note

Spamming the User Forum with marketing materials or other irrelevant content will result in immediate expulsion. Additionally, please read the Code of conduct included below.

Code of conduct

As contributors and maintainers of AtoM, we at Artefactual pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities, including participating in our User Forum.

We are committed to making participation in the AtoM project a harassment-free experience for everyone, regardless of level of experience, sex, gender identity and expression, sexual orientation, ability, personal appearance, body size, race, age, or religion.

Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.

Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, Forum posts, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.

If you feel you've encountered instances of abusive, harassing, or otherwise unacceptable behavior, please let us know.

Seealso

This Code of Conduct is liberally adapted from the Contributor Covenant, version 1.0.0, available at http://contributor-covenant.org/version/1/0/0/

What should I include in a support post?

First, please try searching the AtoM User Forum for previous posts that may answer your question. We also encourage you take a look at the AtoM documentation.

If you can't find any documentation or previous Forum posts that are relevant, then please start a new topic on the User Forum, and be sure to include:

  1. A subject line that briefly describes the problem (e.g. "Error when I try to move my description to another Fonds")
  2. A detailed description of how to reproduce the problem
  3. The full error report you see in your browser. The best way to do this is to take a screenshot of the error page, and attach it to your post, or to save the page itself as HTML and attach that
  4. Which browser you are using (e.g. "Internet Explorer 8", "Firefox 10")
  5. Which version of you AtoM are using (e.g. 2.1.0, 2.2, ICA-AtoM 1.3.2, etc)
  6. If you know about your installation environment, telling us more about it can really help! Are you installed on Linux (which flavor?), or are you virtualizing on another OS? What version of PHP do you have installed? Are you hosting your own instance, or using an external hosting provider? Etc.
  7. What have you already tried to resolve the issue?

Screenshots are always appreciated as it lets us see exactly what you are doing when the error occurs.

Thanks!

Tagging your support post

We have enabled topical tagging in the user forum to help with searching and browsing. If you wish, you can tag your post with keywords - the forum administrators may also add or remove tags later on as we see fit. For more information about what each tag refers to, see User forum tags.