Name: nextcloud.com
Owner: Nextcloud
Description: :earth_asia: Our website https://nextcloud.com
Created: 2016-06-03 18:38:22.0
Updated: 2018-05-23 20:17:34.0
Pushed: 2018-05-24 14:32:27.0
Homepage:
Size: 331203
Language: PHP
GitHub Committers
User | Most Recent Commit | # Commits |
Other Committers
User | Email | Most Recent Commit | # Commits |
README
Contributing to nextcloud.com website
Please take a moment to review this document in order to make the contribution
process easy and effective for everyone involved.
Setup of a local development environment
- Install Wordpress >= 3.8.1
- Must be in the document root of the webserver (otherwise images won't load :( )
- Enter what you like for site title, admin user and password, none of this is stored in git
- Setup the repository
- Clone the repository in a folder of your choice
git clone git@github.com:nextcloud/nextcloud.com next
- In the wordpress installation in the
wp-content/themes
folder, create a link to the folder you just cloned the repository in under the name 'next'
- Activate the theme in
Appearance > Themes
- Import the website
content.xml
file
- First install the Wordpress Import Plugin (via
Tools > Import > Wordpress Import
> Install Plugin
)
- Select the
content.xml
file from the repository and click upload
- Select Import
- Copy over
config.php.sample
to config.php
and adjust settings as necessary (defaults will work just fine for local environments)
Development Process
- Fork the repository
- Setup your local development environment using the instructions above, changing the remote origin url
- Submit a pull request to master, on github once the feature/bugfix is complete (this is so we can test it on the staging server)
- After review (usually following one or two thumbs up), a developer will permit the merge into master
- Code will be pulled onto staging.nextcloud.com for testing (this has to be set up still but the goal is to have this work automatically)
- Once the test looks good, staging will be cloned over to nextcloud.com - this is handled by @jospoortvliet or the Nextcloud sysadmins including @LukasReschke
Notes
- Please don't commit straight into the master or live branches, these branches should remain as stable as possible, and changes should be discussed amongst the community.
- If you are changing SCSS files during development, following command for automatic compilation is recommended:
sass --watch [location to scss files]
Testing
The list below covers most pages on our site, copy it in a PR that needs site-wide testing, so one can just quickly click the links and check all pages:
- [ ] https://nextcloud.com/?staging=true
- [ ] https://nextcloud.com/files/?staging=true
- [ ] https://nextcloud.com/groupware/?staging=true
- [ ] https://nextcloud.com/talk/?staging=true
- [ ] https://nextcloud.com/athome/?staging=true
- [ ] https://nextcloud.com/install/?staging=true
- [ ] https://nextcloud.com/changelog/?staging=true
- [ ] https://nextcloud.com/secure/?staging=true
- [ ] https://nextcloud.com/globalscale/?staging=true
- [ ] https://nextcloud.com/file-drop/?staging=true
- [ ] https://nextcloud.com/sharing/?staging=true
- [ ] https://nextcloud.com/collaboraonline/?staging=true
- [ ] https://nextcloud.com/outlook/?staging=true
- [ ] https://nextcloud.com/workflow/?staging=true all
- [ ] https://nextcloud.com/clients/?staging=true all
- [ ] https://nextcloud.com/storage/?staging=true all
- [ ] https://nextcloud.com/monitoring/?staging=true all
- [ ] https://nextcloud.com/enterprise/?staging=true
- [ ] https://nextcloud.com/pricing/?staging=true
- [ ] https://nextcloud.com/enterprise/buy/?staging=true
- [ ] https://nextcloud.com/enterprise/order/?staging=true
- [ ] https://nextcloud.com/partners/?staging=true
- [ ] https://nextcloud.com/providers/?staging=true
- [ ] https://nextcloud.com/providers/apply/?staging=true
- [ ] https://nextcloud.com/compare/?staging=true
- [ ] https://nextcloud.com/about/?staging=true
- [ ] https://nextcloud.com/press/?staging=true
- [ ] https://nextcloud.com/contact/?staging=true
- [ ] https://nextcloud.com/support/?staging=true
- [ ] https://nextcloud.com/team/?staging=true
- [ ] https://nextcloud.com/healthcare/?staging=true
- [ ] https://nextcloud.com/education/?staging=true
- [ ] https://nextcloud.com/devices/?staging=true
- [ ] https://nextcloud.com/box/?staging=true
- [ ] https://nextcloud.com/events/?staging=true
- [ ] https://nextcloud.com/events/meetups/?staging=true
- [ ] https://nextcloud.com/events/conference-program/?staging=true
- [ ] https://nextcloud.com/events/conference-program/speaking/?staging=true
- [ ] https://nextcloud.com/contribute/?staging=true
- [ ] https://nextcloud.com/design/?staging=true
- [ ] https://nextcloud.com/contributors/?staging=true
- [ ] https://nextcloud.com/partners/?staging=true
- [ ] https://nextcloud.com/release-channels/?staging=true
- [ ] https://nextcloud.com/conf/?staging=true
- [ ] https://nextcloud.com/confinfo/?staging=true
- [ ] https://nextcloud.com/security/?staging=true
- [ ] https://nextcloud.com/security/advisories/?staging=true
- [ ] https://nextcloud.com/security/threat-model/?staging=true
- [ ] https://nextcloud.com/connect/?staging=true
- [ ] https://nextcloud.com/federation/?staging=true
- [ ] https://nextcloud.com/securesharing/?staging=true
- [ ] https://nextcloud.com/spreedbox/?staging=true
- [ ] https://nextcloud.com/code-of-conduct/?staging=true
- [ ] https://nextcloud.com/trademarks/?staging=true
- [ ] https://nextcloud.com/privacy/?staging=true
- [ ] https://nextcloud.com/impressum/?staging=true