-
Notifications
You must be signed in to change notification settings - Fork 2
Add the default README template #17
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
doxigo
wants to merge
3
commits into
master
Choose a base branch
from
doxigo-patch-1
base: master
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,98 @@ | ||
# Insert project name | ||
|
||
Insert here a short desctiption of the project, indicating who is the client and what is the purpose of the project from their point of view. | ||
|
||
## Project overview | ||
|
||
| SITE INFO | | | ||
| ------------- | ----------- | | ||
| **Site status** | 🛠 Development / 🚀 Launched | | ||
| **Launch date** | YYYY/MM/DD or mmm YYYY | | ||
| **Project manager** | [NAME](mailto:[email protected]) | | ||
| **Product owner** | Client name | | ||
| **URL** | https://example.com | | ||
| **URL (staging)** | http://staging.APP_NAME.ramsalt.wod.by/ | | ||
| **URL (dev)** | http://dev.APP_NAME.ramsalt.wod.by/ | | ||
| **Design files** | [Figma or other link](http://figma.com/..) | | ||
| **Hosting platform** | [Wodby](https://cloud.wodby.com/apps/....../) | | ||
| **CMS** | Drupal 9 | | ||
| **Git** | [REPONAME](https://bitbucket.org/ramsalt/?/src/master/) | | ||
| **Chat room** | Slack [`#proj--NAME`](https://ramsalt.slack.com/archives/C...) | | ||
| **Project management** | [TeamWork](https://teamwork.ramsalt.com/#/projects/...) | | ||
| **Documentation** | [Confluence: NAME](https://kb-ramsalt.atlassian.net/wiki/spaces/...) | | ||
|
||
|
||
## Table of Contents | ||
|
||
- [Insert project name](#insert-project-name) | ||
- [Project overview](#markdown-header-project-overview) | ||
- [Table of Contents](#markdown-header-table-of-contents) | ||
- [Local environment](#markdown-header-local-environment) | ||
- [Docker - Docker4Drupal](#markdown-header-docker-docker4drupal) | ||
- [Config splits:](#markdown-header-config-splits) | ||
- [Theming and frontend](#markdown-header-theming-and-frontend) | ||
- [Theme workflow and compiling](#markdown-header-theme-workflow-and-compiling) | ||
- [Theme best practices](#markdown-header-theme-best-practices) | ||
- [Integrations](#markdown-header-integrations) | ||
- [Hosting and deployment](#markdown-header-hosting-and-deployment) | ||
- [Deployment procedure](#markdown-header-deployment-procedure) | ||
- [Misc notes](#markdown-header-misc-notes) | ||
- [Credits](#markdown-header-credits) | ||
- [License](#markdown-header-license) | ||
|
||
|
||
## Local environment | ||
|
||
Write here what is the **recommended** setup process to get the site up and running. Note that the site configuration _should not allow_ to accidentally push data to production systems if the developer does not follow the instructions here, so take care that all the informations reported here must be considered _optional_. | ||
|
||
|
||
#### Config splits | ||
|
||
Define the config environment used to create config splits. An example could be: | ||
|
||
- **Environment: Dev** _(Machine name: `environment_dev`)_: Enabled by default (disabled in `settings.ramsalt.prod.php`), it disables most cache modules, | ||
enables Devel module and database logging. | ||
|
||
|
||
## Theming and frontend | ||
| FRONTEND INFO | | | ||
| --------------- | ----------- | | ||
| **Base theme** | BaseTheme Name | | ||
| **Module bundler** | Webpack 5 | | ||
| **Node version** | v14.15.4 | | ||
| **CSS framework** | Bootstrap 4.6 | | ||
| **JS framework** | Vanilla JS - jQuery 3.5.1 | | ||
| **Additional notes**| None | | ||
|
||
#### Theme workflow and compiling | ||
|
||
Explain the command and the process of the theme. An example could be: | ||
|
||
**Compilation**: Run gulp from the awesome_theme folder. | ||
|
||
|
||
#### Theme best practices | ||
|
||
A description of linting, component based design and how to behave in the theme | ||
|
||
|
||
## Integrations | ||
|
||
Define any 3rd-party integration and any notes on it here | ||
|
||
|
||
## Hosting and deployment | ||
|
||
This project is hosted via Wodby and connected to CircleCI, for managing the `post-script` commands, we use the `wodby.yml` file in the docroot. | ||
Note that the production environment should always be set to the `master` branch. | ||
|
||
|
||
#### Deployment procedure | ||
|
||
The best practice to consider when deploying is to do your changes on `develop` branch, make a pull-request and when approved by the PM, make a database backup of the `prod` instance in Wodby, and merge with `master`. | ||
|
||
|
||
## Misc notes | ||
|
||
Any miscellaneous non-categorable info you may need to add | ||
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
That would overwrite the README every time drupal:scaffold runs. That needs to be prevented.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@doxigo Have you seen this feedback?