Difference between revisions of "Resources/User forum"

From AtoM wiki
(Tagging your support post: Make section title a hyperlink)
m
 
(5 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
[[Main Page]] > [[Resources]] > Resources/User forum
 
[[Main Page]] > [[Resources]] > Resources/User forum
  
This page includes some basic information on the [https://groups.google.com/forum/?hl=en&fromgroups#!forum/ica-atom-users 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.
+
This page includes some basic information on the [https://groups.google.com/forum/?hl=en&fromgroups#!forum/ica-atom-users AtoM User Forum] and the Code of Conduct that governs communication in the group.
  
  
 
===What is the AtoM User Forum?===
 
===What is the AtoM User Forum?===
  
The  [https://groups.google.com/forum/?hl=en&fromgroups#!forum/ica-atom-users 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.
+
The  [https://groups.google.com/forum/?hl=en&fromgroups#!forum/ica-atom-users AtoM User Forum] is the main place where users come to meet and talk with the AtoM community. There has been a vibrant community discussion going on for many years.
 
 
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?===
  
===Who can post in the forum?===
+
Anyone is welcome to join, but '''registration is required to post in the AtoM User Forum'''. All you need is an email address, a google account, and an interest in AtoM. The forum is open to both amateurs and experts; archivists, system administrators, and developers - and more!
  
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!
+
See the section below for registration instructions.
  
 +
===How can I register for the AtoM Forum?===
  
===Is the forum just for technical support?===
+
Because we are using the freely provided forums hosted by Google, you will need a Google account if you don't already have one. First, navigate to the AtoM user forum:
  
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!
+
* [https://groups.google.com/g/ica-atom-users https://groups.google.com/g/ica-atom-users]
  
 +
<br />
  
===What is Artefactual's policy on support in the forum?===
+
If you are not currently logged into your Google account, you will see a sign-in option at the top of the page:
  
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.
+
[[File:forum-create-google-acct.png|center|700px|thumb|The landing page of the AtoM User Forum, with the Google Sign in button highlighted]]
  
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.
+
Click this button - the next page will give you the options to either sign in to an existing account, or create a new account if you don't have one. Sign in or create an account, and follow the prompts
  
 
<admonition type="tip">
 
<admonition type="tip">
If you are interested in commercial support from Artefactual, please see our [http://www.artefactual.com/services/ website] for the services we offer.
+
Did you know? You can create a Google account with an existing email address, even if it's not a Gmail address. For all general information on creating a google account, see Google's resources:
 +
 
 +
* [https://support.google.com/accounts/answer/27441?hl=en https://support.google.com/accounts/answer/27441?hl=en]
 
</admonition>
 
</admonition>
  
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!
+
When you next return to the [https://groups.google.com/g/ica-atom-users AtoM User Forum] and are logged into your Google account, you will now see a button next to the forum name:
 +
 
 +
[[File:forum-ask-to-join.png|center|700px|thumb|The landing page of the AtoM User Forum, with the Ask to Join button highlighted]]
 +
 
 +
Click the button, and a pop-up will appear. Please provide a display name for your forum posts, configure your preferred subscription message delivery, and provide a reason for joining.
 +
 
 +
[[File:forum-reason-for-joining.png|center|400px|thumb|The AtoM User forum registration form pop-up]]
 +
 
  
<admonition type="note">
+
<admonition type="important">
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.
+
'''You MUST provide a reason for joining so we know you are not a bot''' - if you are unsure what to write, you can write "Access to Memory" in the field.
 
</admonition>
 
</admonition>
  
 +
Your request will be submitted to the forum maintainers for review. Please be patient as we review requests!
 +
 +
Once your request has been approved, your posts will also be moderated at first - meaning there will be a delay between when you post and when the post is delivered to other members and visible in the web forum. This is done to prevent spam and automated bot posts.
 +
 +
If you have any issues, and/or you feel that your request has been rejected in error, feel free to contact us at info@artefactual.com, and we will investigate!
 +
 +
===Why isn't my post showing up in the forum?===
  
===Code of conduct===
+
Are you a new member who has joined the AtoM User Forum recently? If so, your posts will be moderated at first, to prevent spam from being sent to all our members accidentally. We apologize for the inconvenience! Odds are good that your post will be visible soon, once it has been reviewed by our moderators. If we reject your post, you will receive a message - otherwise, it's still in the queue
  
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.
+
If you have any issues, or it's been a very long time, and/or you feel that your request has been rejected in error, feel free to contact us at info@artefactual.com, and we will investigate!
  
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.
+
===What is the user forum for?===
  
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.
+
The forum is for members of the AtoM community to meet and talk. Share success stories, strategies, resources, workarounds for known issues, and thoughts related AtoM and the cultural memory community. Let others know about AtoM-related events in your area; help spread the word about a new AtoM site; make plans to connect with other AtoM users at upcoming conferences and events; talk about your ideal workflow and how you use AtoM. The forum is only as interesting as you help to make it!
  
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.
+
===What is Artefactual's policy on technical support in the forum?===
  
'''If you feel you've encountered instances of abusive, harassing, or otherwise unacceptable behavior, please''' [mailto:info@artefactual.com let us know.]
+
Artefactual staff do not provide technical support in the AtoM user forum. Technical issues can be posted in the forum, and other community members may be able to provide help. Artefactual offers technical support for AtoM as part of our commercial services.  Please see our [http://www.artefactual.com/services/ website] for more detail on the services we offer.
  
<admonition type="seealso">
+
Before posting a request for technical support, try searching the [https://groups.google.com/forum/?hl=en&fromgroups#!forum/ica-atom-users AtoM User Forum] for previous posts that may answer your question. We also encourage you take a look at the AtoM [https://accesstomemory.org/docs documentation.]
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/
 
</admonition>
 
  
 +
=== What is the forum policy on commercial or off-topic posts?===
 +
Spamming the AtoM user forum with marketing materials or other irrelevant content will result in immediate expulsion. Additionally, please read the Code of conduct included below.
  
===What should I include in a support post?===
+
===Code of conduct===
  
First, please try searching the [https://groups.google.com/forum/?hl=en&fromgroups#!forum/ica-atom-users AtoM User Forum] for previous posts that may answer your question. We also encourage you take a look at the AtoM [https://accesstomemory.org/docs documentation.]
+
====Our Pledge====
 +
In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity
 +
and orientation.
  
If you can't find any documentation or previous Forum posts that are relevant, then please start a new topic on the [https://groups.google.com/forum/?hl=en&fromgroups#!newtopic/ica-atom-users User Forum], and be sure to include:
+
====Our Standards====
 +
Examples of behavior that contributes to creating a positive environment include:
 +
* Using welcoming and inclusive language
 +
* Being respectful of differing viewpoints and experiences
 +
* Gracefully accepting constructive criticism
 +
* Focusing on what is best for the community
 +
* Showing empathy towards other community members
 +
<br />
 +
Examples of unacceptable behavior by participants include:
 +
* The use of sexualized language or imagery and unwelcome sexual attention or advances
 +
* Trolling, insulting/derogatory comments, and personal or political attacks
 +
* Public or private harassment
 +
* Publishing others' private information, such as a physical or electronic address, without explicit permission
 +
* Other conduct which could reasonably be considered inappropriate in a professional setting
  
# A subject line that briefly describes the problem (e.g. "Error when I try to move my description to another Fonds")
+
====Our Responsibilities====
# A detailed description of how to reproduce the problem
+
Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
# 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
 
# Which browser you are using (e.g. "Internet Explorer 8", "Firefox 10")
 
# Which version of you AtoM are using (e.g. 2.1.0, 2.2, ICA-AtoM 1.3.2, etc)
 
# 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.
 
# What have you already tried to resolve the issue?
 
  
 +
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, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
  
Screenshots are always appreciated as it lets us see exactly what you are doing when the error occurs.
+
====Scope====
 +
This Code of Conduct applies both within project spaces, such as the AtoM User Forum, and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
  
Thanks!
+
====Enforcement====
 +
Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at [mailto:info@artefactual.com info@artefactual.com]. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
  
 +
AtoM user forum participants who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by members of the project's leadership.
  
 
===[[Resources/User forum/Tags|Tagging your support post]]===
 
===[[Resources/User forum/Tags|Tagging your support post]]===
Line 85: Line 116:
 
* [https://groups.google.com/forum/#!forum/ica-atom-users Explore the AtoM User Forum]
 
* [https://groups.google.com/forum/#!forum/ica-atom-users Explore the AtoM User Forum]
 
</admonition>
 
</admonition>
 
  
 
-----
 
-----

Latest revision as of 12:41, 16 May 2024

Main Page > Resources > Resources/User forum

This page includes some basic information on the AtoM User Forum and the Code of Conduct that governs communication in the group.

What is the AtoM User Forum?

The AtoM User Forum is the main place where users come to meet and talk with the AtoM community. There has been a vibrant community discussion going on for many years.

Who can post in the forum?

Anyone is welcome to join, but registration is required to post in the AtoM User Forum. All you need is an email address, a google account, and an interest in AtoM. The forum is open to both amateurs and experts; archivists, system administrators, and developers - and more!

See the section below for registration instructions.

How can I register for the AtoM Forum?

Because we are using the freely provided forums hosted by Google, you will need a Google account if you don't already have one. First, navigate to the AtoM user forum:


If you are not currently logged into your Google account, you will see a sign-in option at the top of the page:

The landing page of the AtoM User Forum, with the Google Sign in button highlighted

Click this button - the next page will give you the options to either sign in to an existing account, or create a new account if you don't have one. Sign in or create an account, and follow the prompts

Tip

Did you know? You can create a Google account with an existing email address, even if it's not a Gmail address. For all general information on creating a google account, see Google's resources:

When you next return to the AtoM User Forum and are logged into your Google account, you will now see a button next to the forum name:

The landing page of the AtoM User Forum, with the Ask to Join button highlighted

Click the button, and a pop-up will appear. Please provide a display name for your forum posts, configure your preferred subscription message delivery, and provide a reason for joining.

The AtoM User forum registration form pop-up

Important

You MUST provide a reason for joining so we know you are not a bot - if you are unsure what to write, you can write "Access to Memory" in the field.

Your request will be submitted to the forum maintainers for review. Please be patient as we review requests!

Once your request has been approved, your posts will also be moderated at first - meaning there will be a delay between when you post and when the post is delivered to other members and visible in the web forum. This is done to prevent spam and automated bot posts.

If you have any issues, and/or you feel that your request has been rejected in error, feel free to contact us at info@artefactual.com, and we will investigate!

Why isn't my post showing up in the forum?

Are you a new member who has joined the AtoM User Forum recently? If so, your posts will be moderated at first, to prevent spam from being sent to all our members accidentally. We apologize for the inconvenience! Odds are good that your post will be visible soon, once it has been reviewed by our moderators. If we reject your post, you will receive a message - otherwise, it's still in the queue

If you have any issues, or it's been a very long time, and/or you feel that your request has been rejected in error, feel free to contact us at info@artefactual.com, and we will investigate!

What is the user forum for?

The forum is for members of the AtoM community to meet and talk. Share success stories, strategies, resources, workarounds for known issues, and thoughts related AtoM and the cultural memory community. Let others know about AtoM-related events in your area; help spread the word about a new AtoM site; make plans to connect with other AtoM users at upcoming conferences and events; talk about your ideal workflow and how you use AtoM. The forum is only as interesting as you help to make it!

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

Artefactual staff do not provide technical support in the AtoM user forum. Technical issues can be posted in the forum, and other community members may be able to provide help. Artefactual offers technical support for AtoM as part of our commercial services. Please see our website for more detail on the services we offer.

Before posting a request for technical support, 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.

What is the forum policy on commercial or off-topic posts?

Spamming the AtoM 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

Our Pledge

In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.

Our Standards

Examples of behavior that contributes to creating a positive environment include:

  • Using welcoming and inclusive language
  • Being respectful of differing viewpoints and experiences
  • Gracefully accepting constructive criticism
  • Focusing on what is best for the community
  • Showing empathy towards other community members


Examples of unacceptable behavior by participants include:

  • The use of sexualized language or imagery and unwelcome sexual attention or advances
  • Trolling, insulting/derogatory comments, and personal or political attacks
  • Public or private harassment
  • Publishing others' private information, such as a physical or electronic address, without explicit permission
  • Other conduct which could reasonably be considered inappropriate in a professional setting

Our Responsibilities

Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.

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, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.

Scope

This Code of Conduct applies both within project spaces, such as the AtoM User Forum, and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.

Enforcement

Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at info@artefactual.com. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.

AtoM user forum participants who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by members of the project's leadership.

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.