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

Refactor README.md

Open vaibhav135 opened this issue 2 years ago โ€ข 5 comments

Is your proposal related to a problem?

Hi, I am a new contributor here and while setting up the project in my local machine. I found that a lot of the things that are mentioned in the README are outdated.

Describe the solution you'd like

As of now I have found few things to update.

  • Suggest a new way to setup database (since heroku is not free anymore). I suggest setting db locally or something like railway or render.
  • In the intergration section here, It should also be mentioned that we need to save our apps related env's in .env.appStore. And also that the DATABASE_URL will be in both the env's i.e .env and .env.appStore.

Additional context

For now I only know about these two things but I would love to have suggestion on the other things that needs updation.

vaibhav135 avatar Apr 23 '23 06:04 vaibhav135

We are working on a sync between github and Motif for consistent documentation synchronization. You can take a look at cal.com/docs in the mean time for up to date docs. ๐Ÿ™ I believe we would currently be updating the readme to point to our official docs at cal.com/docs until the synchronization is ready.

alishaz-polymath avatar Apr 28 '23 11:04 alishaz-polymath

@alishaz-polymath I am looked at cal.com/docs and couldn't find much about setting setting up the project in local. And integration of these apps in local?

vaibhav135 avatar Apr 29 '23 04:04 vaibhav135

@alishaz-polymath I am looked at cal.com/docs and couldn't find much about setting setting up the project in local. And integration of these apps in local?

I'm not entirely sure what part are you referring to. We have the local setup steps mentioned here: https://cal.com/docs/introduction/quick-start/self-hosting/installation ๐Ÿค” And apps here: https://cal.com/docs/introduction/quick-start/self-hosting/install-apps

alishaz-polymath avatar Apr 29 '23 19:04 alishaz-polymath

@alishaz-polymath Thanks for the info. Actually I was trying the fine the local setup in this section -> https://cal.com/docs/knowledgebase/contributors-guide . Btw can I make a PR for the suggested changes if those makes sense. I will also try to sync the current README.me with the cal.com docs.

vaibhav135 avatar May 01 '23 08:05 vaibhav135

Of course, thanks ๐Ÿ™ Much appreciated!

alishaz-polymath avatar May 01 '23 08:05 alishaz-polymath