firebaseopensource.com icon indicating copy to clipboard operation
firebaseopensource.com copied to clipboard

Document the architecture and deployment steps (where possible)

Open samtstern opened this issue 6 years ago • 3 comments

slaps roof this bad boy can fit so many moving parts in it.

We should create some basic documentation so that when we forget how it works, we can remember. It's like The Notebook and @abehaskins is Rachel McAdams.

samtstern avatar Aug 08 '18 15:08 samtstern

I believe this would also help more people from the community contribute to this project. Maybe they would be able to fix the other issues we have here, so this one should probably be prioritized.

thatfiredev avatar Oct 19 '18 08:10 thatfiredev

If you want to mess with the frontend, that part is pretty simple:

$ cd frontend
$ npm install
$ npm run dev

Then you'll have a local server that will automatically rebuild and refresh on any changes. That said I guess you won't have any data ... I wonder if giving the real data set public readability is a terrible idea.

Also while it hardly counts as documentation, the Makefile gives some idea of what's going on with the backend: https://github.com/firebase/firebaseopensource.com/blob/master/Makefile

samtstern avatar Oct 19 '18 15:10 samtstern

@samtstern This is actually helpful. Thanks!

thatfiredev avatar Oct 19 '18 16:10 thatfiredev