Skip to content

Commit

Permalink
developer guide forum instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
@jodygarnett
jodygarnett committed Nov 21, 2024
1 parent f1766a5 commit 9af2719
Show file tree
Hide file tree
Showing 6 changed files with 151 additions and 80 deletions.
4 changes: 4 additions & 0 deletions _includes/code-of-conduct.html
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
<!-- text should be kept in sync with https://github.com/geoserver/geoserver/blob/main/CODE_OF_CONDUCT.md -->
<p>
GeoServer communication channels follow the <a href="https://github.com/geoserver/geoserver/blob/main/CODE_OF_CONDUCT.md">contributor code of conduct</a>. This is the code of conduct policy <a href="https://www.osgeo.org/code_of_conduct/">recommended by OSGeo</a>. In addition please ensure you have read through the <a href="/comm/userlist-guidelines.html">guidelines</a> before creating a post.
</p>
61 changes: 35 additions & 26 deletions comm/index.html
View file
Original file line number Diff line number Diff line change
@@ -1,33 +1,33 @@
---
layout: default
title: Community - GeoServer
title: Community Support - GeoServer
id: comm
---

<h1>Community support</h1>
<p class="lead">
The GeoServer community utilizes multiple channels of communication.
</p>

<p>
This page should help you find the public communication channel best suited for your needs.
</p>
<ul>
<li><a href="#discourse">GeoServer User Forum</a>
<li><a href="#stack">Public Q & A Forums</a>
<li><a href="#social">Social</a>
<li><a href="#slack">Chat</a>
<li><a href="#chat">Chat</a>
</ul>

<p>
This page should help you find the public communication channel best suited for your needs.
</p>
<p>
If you are not in a position to communicate in public, please contact one of our <a href="/support">commercial support</a> providers.
</p>

<div class="alert alert-info">
<h4>Code of Conduct</h4>
GeoServer communication channels follow the <a href="https://github.com/geoserver/geoserver/blob/main/CODE_OF_CONDUCT.md">contributor code of conduct</a>. This is the code of conduct policy <a href="https://www.osgeo.org/code_of_conduct/">recommended by OSGeo</a>. In addition please ensure you have read through the <a href="userlist-guidelines.html">guidelines</a> before creating a post on the user list.
</div>
<h4>Code of Conduct</h4>

{% include code-of-conduct.html %}
</div>

<a id="disclosure"></a>
<div class="alert alert-info">
<h4>Security Vulnerabilities</h4>
Expand All @@ -45,7 +45,7 @@ <h2>GeoServer User Forum</h2>
</p>
<p>
<div class="alert alert-info">
The GeoServer User forum is hosted on <a href="https://discourse.osgeo.org/c/geoserver/user">Discourse</a> provided by the Open Source Geospatial Foundation. The forum contains all 20+ years of content from the archived SourceForge email list.
The GeoServer User forum is hosted on <a href="https://discourse.osgeo.org/c/geoserver/user/51">Discourse</a> provided by the Open Source Geospatial Foundation. The forum contains all 20+ years of content from the archived SourceForge email list.
</div>

<section>
Expand All @@ -59,20 +59,23 @@ <h4>Discourse Forum Sign In</h4>
<ol>
<li>Login to <a href="https://discourse.osgeo.org/">discourse.osgeo.org</a>:
<ul>
<li>Login <b>with LDAP</b> to use your OSGeo UserID (also used for <a href="https://www.osgeo.org/community/getting-started-osgeo/osgeo_userid/">other osgeo services</a>).</li>
<li>Use "Log in with GitHub" to use GitHub credentials.</li>
<li>Developers "Log in with GitHub" to use GitHub credentials.</li>
<li>Vistors can use <b>Sign Up</b> to create an account for use with the Forum.</li>
<li>OSGeo Members use <b>with LDAP</b> sign in with OSGeo UserID.</li>
</ul>
<p>
OSGeo provides <a href="https://discourse.osgeo.org/t/welcome-to-osgeo/5">step by step instructions</a>
on signing into discourse using GitHub, OSGeo User ID LDAP, or setting up a new account.</a>
</p>
<img src="/img/posts/2.25/discourse-login.png" alt="Discourse Login" width="50%" height="50%">
<li>You may also use <b>Sign Up</b> if you want to create an account only for use with the Forum.
<br/>
<img src="/img/posts/2.25/discourse-login.png" alt="Discourse Signup" width="60%" height="60%">
</li>
<li>Navigate to <a href="https://discourse.osgeo.org/c/geoserver/user/51">GeoServer / Users</a> to enjoy the forum.<br/>
<img src="/img/posts/2.25/discourse-forum.png" alt="Discourse Signup" width="60%" height="60%">

</li>
<li>Use <b>New Topic</b> to start a new conversation.</br>
Only the <code>GeoServer / user</code> subcategory allows new topics. If the <b>New Topic</b> button is disabled you may be looking at the <code>GeoServer</code> top-level category.
<li>Use <b>New Topic</b> to start a new conversation.
<div class="alert alert-info">
Only the <code>GeoServer / user</code> subcategory allows new topics. If the <b>New Topic</b> button is disabled you may be looking at the <code>GeoServer</code> top-level category.
</div>
</li>
<li>
To test please send introduce yourself we are looking forward to meeting you.
Expand All @@ -88,9 +91,9 @@ <h4>Discourse use as mailing list</h4>

<ol>
<li>Sign-in to Discourse Forum as above</li>
<li>From your profile <b>Preferences</b>, use the <b>Email</b> tab to adjust email settings.
<li>From your profile <b>Preferences</b>, use the <b>Emails</b> tab to adjust email settings.
<br/>
<b>IMPORTANT</b>: Enable "mailing list mode" to get email (to avoid missing email when using discourse website!)
<b>IMPORTANT</b>: Enable <b>Mailing list mode</b> to get all email. This setting avoids missing email when discourse website is open.
<br/>
<img src="/img/posts/2.25/discourse-email-preferences.png" alt="Discourse Email Preferences" width="70%" height="70%">
</li>
Expand Down Expand Up @@ -127,15 +130,21 @@ <h2>Social Media</h2>
<p>
Connect with GeoServer enthusiasts worldwide:
</p>
<ul>
<li><i class="fa-brands fa-linkedin"></i> <a href="https://www.linkedin.com/groups/813717/">GeoServer Group</a></li>
<li><i class="fa-brands fa-mastodon"></i> <a href="https://fosstodon.org/@geoserver">@[email protected]</a> | <a href="https://fosstodon.org/tags/geoserver">#GeoServer</a></li>
<li><i class="fa-brands fa-square-bluesky"></i> <a href="https://bsky.app/profile/geoserver.org">@geoserver.org</a> | <a href="https://bsky.app/hashtag/GeoServer">#GeoServer</a></li>
<li><i class="fa-brands fa-square-x-twitter"></i> <a href="https://x.com/geoservero">@GeoserverO</a> | <A href="https://x.com/hashtag/GeoServer">#GeoServer</a></li>
<ul class="social">
<li><i class="fa-brands fa-linkedin"></i> <a href="https://www.linkedin.com/groups/813717/">GeoServer Group</a></li>
<li><i class="fa-brands fa-mastodon"></i> <a href="https://fosstodon.org/@geoserver">@[email protected]</a> | <a href="https://fosstodon.org/tags/geoserver">#GeoServer</a></li>
<li><i class="fa-brands fa-square-bluesky"></i> <a href="https://bsky.app/profile/geoserver.org">@geoserver.org</a> | <a href="https://bsky.app/hashtag/GeoServer">#GeoServer</a></li>
<li><i class="fa-brands fa-square-x-twitter"></i> <a href="https://x.com/geoservero">@GeoserverO</a> | <A href="https://x.com/hashtag/GeoServer">#GeoServer</a></li>
</ul>
<p>
The GeoServer Brazilian community (Portuguese):
</p>
<ul class="social">
<li><i class="fa-brands fa-square-whatsapp"></i> <a href="https://geoserver.com.br/whatsapp">GeoServer Group Invite</a></li>
<p>
</section>

<a id="slack"></a>
<a id="chat"></a>
<section>
<h2>Chat</h2>
<p>
Expand Down
19 changes: 12 additions & 7 deletions comm/userlist-guidelines.html
View file
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
layout: default
title: User group posting guidelines
title: Forum posting guidelines
id: comm-ul-guidelines
---

<h1>User forum posting guidelines</h1>
<h1>Forum posting guidelines</h1>

<p class="lead">
Regardless of whether you are just starting out with GeoServer or have been using it for years, we encourage you to subscribe to the <a href="https://discourse.osgeo.org/c/geoserver/users" rel="nofollow">GeoServer User Forum</a> and take an <b>active</b> part in the community. To help make the user group as useful and friendly as possible, we ask you to observe the following guidelines.
Regardless of whether you are just starting out with GeoServer or have been using it for years, we encourage you to subscribe to the <a href="https://discourse.osgeo.org/c/geoserver/user/51" rel="nofollow">GeoServer User Forum</a> and take an <b>active</b> part in the community. To help make the user group as useful and friendly as possible, we ask you to observe the following guidelines.
</p>

<section>
Expand All @@ -16,20 +16,21 @@ <h2>Security Vulnerabilities</h2>
<strong>Keep exploit details out of public forums, mailing lists, and issue tracker.</strong>

{% include disclosure.html %}



</section>

<section>
<h2>Code of Conduct</h2>
<p>
<strong>Be kind to yourself and others.</strong>
<p>
GeoServer communication channels follow the <a href="https://github.com/geoserver/geoserver/blob/main/CODE_OF_CONDUCT.md">contributor code of conduct</a>. This is the code of conduct policy <a href="https://www.osgeo.org/code_of_conduct/">recommended by OSGeo</a>.

{% include code-of-conduct.html %}

<p>
We also ask that you be respectful to yourself, all technology can be difficult, and GeoServer is a community effort. If you are having difficulty do not blame yourself (which is disrespectful) and identify an area where you can ask for assistance and improve the technology, documentation, or provide a bug report.
</p>
</section>

<section>
<h2>Take a little, give a little</h2>
<p>
Expand All @@ -39,6 +40,7 @@ <h2>Take a little, give a little</h2>
If we notice you ask questions without ever helping other people, we'll be less inclined to help you in return instead (but don't panic, if you don't care about participating, commercial support providers can handle your needs).
</p>
</section>

<section>
<h2>Start discussions on the Discourse forum, keep it on the Discourse forum</h2>
<p>
Expand All @@ -48,6 +50,7 @@ <h2>Start discussions on the Discourse forum, keep it on the Discourse forum</h2
However, it's fine to send private messages if you are trying to share sensitive information which is necessary to solve the issue, or if you are trying to engage a developer in a commercial development /support contract.
<p>
</section>

<section>
<h2>Be polite</h2>
<p>
Expand All @@ -59,6 +62,7 @@ <h2>Be polite</h2>
GeoServer activities follow the <a href="https://github.com/geoserver/geoserver/blob/master/CODE_OF_CONDUCT.md">Contributor Covenant Code of Conduct</a> as part of the Open Source Geospatial Foundation <a href="https://www.osgeo.org/code_of_conduct/">commitment to diversity</a>.
</p>
</section>

<section>
<h2>Check first, the answer might already be out there</h2>
<p>
Expand All @@ -75,6 +79,7 @@ <h2>Check first, the answer might already be out there</h2>
</ul>
</p>
</section>

<section>
<h2>Post enough (but not too much)</h2>
<p>
Expand Down
4 changes: 4 additions & 0 deletions css/app.css
View file
Original file line number Diff line number Diff line change
Expand Up @@ -124,6 +124,10 @@ ul.experience li {
margin: 2px 4px 2px 0px;
}

ul.social {
list-style: none;
}

blockquote p {
font-size:14px;
line-height:20px
Expand Down
Loading

0 comments on commit 9af2719

Please sign in to comment.