Update 'Best Practices'
parent
c2b62baf28
commit
deccd80ddf
37
Best-Practices.md
Normal file
37
Best-Practices.md
Normal file
@ -0,0 +1,37 @@
|
|||||||
|
## Using data
|
||||||
|
|
||||||
|
### Docker
|
||||||
|
|
||||||
|
When using Docker, it is ideal to run the import routines during the build process, or possibly in the entrypoint.
|
||||||
|
|
||||||
|
### Bundling datasets
|
||||||
|
|
||||||
|
It is possible to add the .zip packages of the datasets to your repository, as long as you add the directory as an artifact repository in your composer.json:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
...
|
||||||
|
"repositories": [
|
||||||
|
{ "type": "artifact", "url": "dist/packages" }
|
||||||
|
],
|
||||||
|
...
|
||||||
|
}
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
## Datasets
|
||||||
|
|
||||||
|
### Versioning
|
||||||
|
|
||||||
|
As the data in most datasests is considered fresh at the time of packaging, the version numbers really should reflect when the data was prepared. We have decided on the year as minor version for our packages, leaving the major version for updates that may break schemas.
|
||||||
|
|
||||||
|
**Recommended format:**
|
||||||
|
|
||||||
|
```
|
||||||
|
0.22.10.4
|
||||||
|
| | | |__ Revision
|
||||||
|
| | |_____ Month of build
|
||||||
|
| |________ Year or build
|
||||||
|
|__________ Data format revision
|
||||||
|
```
|
||||||
|
|
Loading…
Reference in New Issue
Block a user