Skip to content
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

Improvements to the "Local Development" documentation #677

Open
robotichead opened this issue Oct 4, 2024 · 3 comments
Open

Improvements to the "Local Development" documentation #677

robotichead opened this issue Oct 4, 2024 · 3 comments
Assignees

Comments

@robotichead
Copy link
Collaborator

https://nearbeach.readthedocs.io/en/latest/002-local-development-environment-setup/index.html

Currently the documentation is missing vital information, and will need to be updated so users can easily setup NearBeach locally.

@ultralegendary
Copy link

Hi, I would like to contribute to this. Can you assign this to me.

@ultralegendary
Copy link

hi @robotichead ,
I have restructured the documentation. Can you review this and let me know if this looks good?

Can you shed some light around this topics so that I can get clarity and know what I have missed.

  • Do we dont need to add Database and Blob storage setup? They are mentioned in the Docker setup, so the doubt.
  • Do you have a list of things that needs to be added, or a list of things for which the users have faced issues.
  • I am not sure about the use of NPM here. I was not able to find any reference on its funcitionality for this project. As I completed the python setup, I was able to access the server, so it would be nice if you could provide me some reference around the use of NPM/JS. 😄

Thanks

@robotichead
Copy link
Collaborator Author

robotichead commented Oct 7, 2024

Hey @ultralegendary ,

Thank you very much for this. :D

Do we dont need to add Database and Blob storage setup? They are mentioned in the Docker setup, so the doubt.

The database will be SQLite for any local environments. Setting up a development database for your local environment I would say is very optional.

As for the blob storage, this is something I have missed in the documentation. It might be an idea to tell the user that this is an optional step if they want to enable uploads/downloads

Do you have a list of things that needs to be added, or a list of things for which the users have faced issues.

At the moment, I am up for any recommendations on what is missing and what is needed. A fresh pair of eyes will definitely help.

I am not sure about the use of NPM here.

That is fine :D Luckily the setup of the npm is really simple :)

Once again, thank you. We have merged in your changes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants