Skip to content
Snippets Groups Projects
Commit b0293a44 authored by Carina Antunes's avatar Carina Antunes
Browse files

Merge branch 'refactor-landing-page' into 'master'

Add new landing page with disclaimers

See merge request drupal/paas/drupal-documentation!34
parents 1a1fdef2 32ad551b
No related branches found
No related tags found
No related merge requests found
---
slug: /
---
# Drupal
Welcome to **drupal.docs.cern.ch**, your one-stop Drupal resource at CERN.
## Support
We strive to make these docs your go-to place for anything Drupal.
We are continuously expanding the website with guides and tutorials for most use-cases.
There are various ways to get in touch, depending on your needs:
- Mattermost channel [Drupal Infra](https://mattermost.web.cern.ch/it-dep/channels/drupal) is a place for informal, technical exchange with the community and with the service managers.
- [Drupal Community Forum](https://drupal-community.web.cern.ch) is a place for informal, technical exchange with advanced users from the community.
- For any questions or concerns regarding the service or your website, please open a [ticket](https://cern.service-now.com/service-portal?id=service_element&name=Drupal-Service).
## Roadmap
The Drupal service follows as close as possible the Drupal release cycle and support at most two versions at the same time.
Once a Drupal release becomes end-of-life(EOL) it won't be supported at CERN as well.
Users must ensure their website in running the supported Drupal version to receive support.
All updates and upgrades are communicated to the users via the [Notifications service](cern.ch/n-91d) and/or via a [Service Status Board](https://cern.service-now.com/service-portal?id=service_status_board) announcement.
**The only supported version currently is Drupal 10.** Drupal 10 is expected to be supported at CERN until mid of 2026.
Drupal 9 is EOL since November 2023.
## Service Level
Drupal is a service centrally provided by the IT department in close collaboration with the Web Team (IR-ECO).
:::info Website development
No expertise or support is provided regarding website development. **Support is limited to the infrastructure maintenance or website malfunction.**
For guidance regarding Drupal development or theming consider reaching other community experts via the means indicated just bellow on [support](#support).
:::
### User responsibility
As any IT offering, it must follow CERN's rules, regulations and guidelines, such as design, accessibility and security guidelines.
The service must adhere as well to CERN Web Presence guidelines.
In this way, all users must adhere to all guidelines indicated thought out the documentation or risk having their website blocked without prior notice.
Additionally, make sure you follow all the guidelines under [Data Privacy](#data-privacy).
#### CERN Drupal Distribution and customisation
CERN provides and maintains a curated collection of Drupal modules called the CERN Drupal Distribution. For the full list please refer to [Introduction to Modules](/modules).
Anything used above what's centrally provided is the sole responsibility of the website owner and its administrators.
**Please do note that the official advice is that users should refrain from installing any additional module or theme to their website!**
Conforming exclusively to the central distribution is the only way to ensure smooth operations, and to benefit from centrally provided upgrades and migrations.
If you inherit a customized website, the general recommendation is to attempt simplifying it, stripping away any customisation and ensuring conformance with what is centrally offered.
:::warning Customisation disclaimer
Please note that installing and using custom modules requires:
- (a) continuous maintenance and
- (b) continuous attention to updates, security patches, and new feature releases.
- (c) ensuring compatibility with the supported Drupal version.
- (d) manual work for the webmaster who will have to carefully check that everything works as expected on their side everytime any central upgrade is available.
Once any Drupal version becomes end-of-life, it will not receive further security updates. And so using it, will put the website, and consequently CERN's reputation at risk.
Although we try to accommodate the users and their websites requirements, upgrades at some point will be forced, even if breaking compatibility with some custom modules.
Indeed, any website is a living and breathing piece of software.
**This work will solely be the responsibility of the website owner(s) as any custom module not in the CERN Drupal Distribution will not benefit from the centrally managed updates.**
If you require a set-and-forget solution, please do not exceed what is offered in the CERN Drupal Distribution.
By using this service with custom modules, you agree to take active part in the upgrades process, allowing us to follow the upstream release cycles in due time.
:::
In the event that the modules provided via the CERN Drupal Distribution) are not sufficient for your needs, we recommend you either:
- post on the CERN Drupal Community Forums/Mattermost to see whether others have already achieved what you are looking for;
- submit a request to the Drupal Team to evaluate whether the feature(s) you require can be accommodated by adding a new module to the CERN Drupal Distribution, benefiting all CERN websites.
## Data privacy
Please refer to the information in the CERN's Data Privacy Office website and make sure that you read and agree with the [Drupal service Data Privacy Police](https://cern.service-now.com/service-portal?id=privacy_policy&se=Drupal-Service&notice=drupal-service) before using the service.
Additionally, make sure you follow all the guidelines under [Cookie Policy](/cookie-policy).
## How can I help?
This documentation is open and accessible by everyone with a CERN account.
If you spot an error, a typo, or would like to propose changes, please click _Edit this page_ at the bottom of any page.
Clicking this link takes you to the below screen directly on our Gitlab page (https://gitlab.cern.ch/drupal/paas/drupal-documentation/).
On here, you can submit your proposed changes.
We will then review your submissions and update the documentation accordingly.
We intend for this documentation to be living and breathing.
---
slug: /
slug: /introduction
---
# Introduction
Welcome to **drupal.docs.cern.ch**, your one-stop Drupal resource at CERN.
# Introduction
If you have no idea what Drupal is, please read on!
......@@ -61,28 +60,3 @@ In fact, the Web Team (IR-ECO-PRD) has prepared a one-click Easy Start template
Additionally, because Drupal is widely used across CERN, chances are someone in your team or group already has some experience!
If you have very specific requirements not immediately covered by any of the default modules, knowledge of PHP fast becomes necessary.
---
### How can I get help?
We strive to make these docs your go-to place for anything Drupal.
We are continuously expanding the website with guides and tutorials for most use-cases.
If you have any questions or concerns, please refer to the [CERN Drupal Community forum](https://drupal-community.web.cern.ch/).
### How can I help?
This documentation is open and accessible by everyone with a CERN account.
If you spot an error, a typo, or would like to propose changes, please click _Edit this page_ at the bottom of any page.
Clicking this link takes you to the below screen directly on our Gitlab page (https://gitlab.cern.ch/drupal/paas/drupal-documentation/).
On here, you can submit your proposed changes.
We will then review your submissions and update the documentation accordingly.
![Submitting a change via Gitlab to the Drupal Docs.](/assets/img/1-getting-started/submitting_a_fix.png)
<p className="image-caption-shadow">Submitting a change via Gitlab to the Drupal Docs.</p>
We intend for this documentation to be living and breathing.
Thank you!
---
slug: /privacy-notes
slug: /cookie-policy
---
# Notes on Privacy
# Cookie Policy
:::danger
The following information applies strictly to the CERN Drupal Distribution.
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment