WIP - Hvordan bidra til prosjektet
Denne siden er et forslag til hvordan en CONTRIBUTING dokumentasjon kan se ut. TDT4140 - Gruppe 23 ser det ikke nødvendig å fullføre denne dokumentasjonen, og etterlater dette til utviklingsteamet som tar over produktet etter oss, ettersom de har indikert at de ønsker at repoet skal følge en open-source prosjektmodell, og vi ikke kjenner til hvordan de ønsker at bidragsprosessen skal gjennomføres. Utviklingsteamet som tar over oppfordres til å gjøre de endringene de ser nødvendig.
[[TOC]]
TODO: Skrive en introduksjon med en generell oversikt over hva seg som må gjennomføres for å kunne bidra til prosjektet.
- Klone repoet
- Installasjon
- Osv...
Repoet kan klones direkte i visual studio code, eller ved å skrive git clone https://gitlab.stud.idi.ntnu.no/tdt4140-2020/23/
i terminalen/cmd, dette krever at du har git installert.
Vi anbefaler at du installer både frontend og backend for å bidra til prosjektet.
Følgende avhengigheter må installers for å kjøre prosjektet lokalt:
- Åpne rooten av repoet i terminalen/cmd
- Skriv i terminalen:
cd frontend
- Skriv i terminalen:
npm install
- Skriv i terminalen
npm start
(For Mac OS X, erstatt python
med python3
)
- Åpne rooten av repoet i terminalen/cmd
- Kjør kommandoen
pipenv shell
. Denne kommandoen oppretter et virtuelt utviklingsmiljø, der vi kan installere nødvenige tillegspakker til python. - Kjør kommandoen
pipenv install
. Denne kommandoen installerer nødvengdige pakker som er spesifisert i pipfile og pipfile.lock - Gå til backend-mappen ved å kjøre
cd backend
i terminalen. - Kjør
python manage.py migrate
. Denne kommandoen lager databasen med modellene spesifisert i migrations - Kjør
python manage.py loaddata demodata.json
. Denne kommandoen laster inn annonser og brukere som er definert i filen demodata.json. - Start serveren ved å kjøre
python manage.py runserver
(Etter å ha gjort alle disse stegene én gang, trenger man bare punkt 1, 2, 4 og 7 for å starte backend-serveren igjen.)