Skip to content

Commit 1e13bea

Browse files
committed
communities: add "About communities" and "Manage" pages
1 parent 23d3cda commit 1e13bea

13 files changed

Lines changed: 166 additions & 8 deletions

docs/communities/communities.md

Lines changed: 54 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,57 @@
11
# Communities
22

3-
## New community
3+
On CDS, communities are spaces in which records are curated by specific groups of people, depending on the community's scope.
4+
Depending on each community's settings, they can allow:
45

5-
## Your communities
6+
- **Curating** records; specific community members can review submitted records before publication.
7+
- **Managing permissions** by specifying which users or CERN Groups can submit new records.
8+
- **Creating custom pages** such as an About page or a Curation Policy
9+
10+
All records on CDS belong to at least one community.
11+
When a record is created, it must be submitted to a community, but after publication it can also be submitted
12+
to additional ones.
13+
14+
## Create a community
15+
16+
In order to ensure communities have a coordinated, user-friendly structure, we don't allow users to create communities directly.
17+
The CDS team creates communities on request, following careful evaluation.
18+
Please [contact the CDS team via ServiceNow](https://cern.service-now.com/service-portal?id=sc_cat_item&name=request&se=CDS-Service), specifying the following details:
19+
20+
- The intended name
21+
- A square logo (maximum 1MB)
22+
- A short description of what the community will be used for
23+
- The type of records that will be published in the community (please send links to examples if possible)
24+
- Whether reviews should be mandatory for newly submitted records (see [Submission policy](./manage.md#submission-policy))
25+
- Whether the community's contents should be publicly visible
26+
- The name of a dedicated [GMS group](https://auth.docs.cern.ch/groups/overview/) to set as the initial member of the community
27+
28+
## Members and roles
29+
30+
Communities have members, each with a role which describes their level of access.
31+
A member can be a CERN user or a group.
32+
Community owners can specify the initial members, which can then later be edited.
33+
34+
Each member can have one of the following roles:
35+
36+
- **Reader**: Can view all records inside the community, including restricted ones.
37+
- **Curator**: Can curate/review records submitted to the community and can view all records.
38+
- **Manager**: Can manage members and roles, can curate records, and can view all records.
39+
- **Owner**: Full administrative control over all aspects of the community.
40+
41+
!!! info "Access for non-members of the community"
42+
43+
CDS users who are not members of a community can still view its public records and its details.
44+
This can be changed in the community's settings.
45+
46+
Non-members cannot view the community's restricted records, unless they have been granted [explicit permission](../deposit/access-share.md) on a per-record basis.
47+
48+
[Find out more](./manage.md#members) about managing community members.
49+
50+
## View your communities
51+
52+
To view the communities you are a member of, or to see a full list of communities on CDS, click on the "Communities" tab at the top of the page.
53+
54+
![Communities tab on the CDS website](./images/communities_tab.png)
55+
56+
The communities you are a member of are listed under "My communities", while the latest communities created on CDS are under "New communities".
57+
To show more results in either section and to search for communities, click "See all".
73.3 KB
Loading
30.1 KB
Loading
71.6 KB
Loading
51.4 KB
Loading
87.7 KB
Loading
73.8 KB
Loading
56.5 KB
Loading
48.2 KB
Loading
28.4 KB
Loading

0 commit comments

Comments
 (0)