You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+7-23
Original file line number
Diff line number
Diff line change
@@ -7,23 +7,23 @@ R documentation sifts through all CRAN, GitHub and BioConductor packages hourly,
7
7
The RDocs project is completely open-source. This repository contains the source code for the NodeJS web application that serves [www.rdocumentation.org](https://www.rdocumentation.org). For other codebases, you can check out [`CONTRIBUTING.md`](CONTRIBUTING.md).
8
8
9
9
## Features
10
-
11
-
- Quick search through all packages and functions
12
-
10
+
- Quick search through all packages and functions
11
+
13
12

14
-
13
+
15
14
- Complete search through all packages and function
16
-
15
+
17
16

18
-
17
+
19
18
- Easily assess package quality
20
19
21
20

22
21
23
-
- Post _community examples_ to help the community understand how to use a function
22
+
- Post *community examples* to help the community understand how to use a function
24
23
25
24

26
25
26
+
27
27
## What this app does
28
28
29
29
This application is part the rdocumentation project. This app is responsible for storing the RDocumentation data, and bring it to the users through a web interface (the rdocumentation.org site) or through an api (See https://www.rdocumentation.org/docs/ for the public API)
@@ -33,33 +33,19 @@ This application is part the rdocumentation project. This app is responsible for
33
33
Documentation of the differents endpoints can be found here: http://www.rdocumentation.org/docs/
34
34
35
35
## Issue/Feature request
36
-
37
36
Please post a new issue at https://github.com/datacamp/rdocumentation-app/issues for any bug that you encounter or a feature that you would like to see in rdocumetation.org.
38
37
39
38
## Development
40
39
41
40
### Using docker
42
-
43
41
You'll need docker and docker-compose to run this stack locally
44
42
45
43
- Copy the .env.sample to .env and change relevant variables
46
44
-`docker-compose create` to create the redis and mysql container
47
45
-`docker-compose start` to fire up a local redis an mysql
48
-
- Use the same node version in your terminal as the Dockerfile is using: `nvm use 8.16`
49
-
-`npm install`
50
46
- Run the database migrations by doing `npm run migrate`
51
47
-`npm run start-dev`
52
48
53
-
### Troubleshooting
54
-
55
-
If you get an error: `SequelizeConnectionError: ER_NOT_SUPPORTED_AUTH_MODE: Client does not support authentication protocol requested by server; consider upgrading MySQL client`
56
-
follow these steps:
57
-
58
-
1. Access your mysql container: you can do it either through the docker app by clicking on the "cli" button of the container, or in your terminal by running `docker exec -it <mysql_container_id> bash`
59
-
2.`mysql -u root -p`
60
-
3. Enter: `password`
61
-
4.`ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password'`
62
-
63
49
## How to deploy
64
50
65
51
- To deploy to stating (rdocumentation.datacamp-staging.com), merge to master
@@ -70,15 +56,13 @@ The rdocumentation app is hosted on DataCamp's infrastructure, on our AWS ECS cl
70
56
## What the CI does
71
57
72
58
This application runs on the DataCamp infrastructure. Our custom CI flow will:
73
-
74
59
- Build a docker image
75
60
- Upload it the ECR
76
61
- Deploy the new version to ECS
77
62
78
63
## How to contribute
79
64
80
65
We welcome any contributions that could improves rdocumentation.org. There is multiple ways of contributing:
81
-
82
66
- Report when some packages are missing/outdated/incorrect by creating an issue.
0 commit comments