Comments (8)
Transferring to docs, since this seems to be a docs issue, not a product issue.
from docs.
Great, it's best to discuss docs changes here, since it has more visibility and allows for collaboration. This issue is just to clarify the installation installations in the docs. If your changes are broader, then I suggest opening a separate issue.
from docs.
I did refactor the AWS guide, I decided to install Parse Dashboard Globally and Parse-Server locally but without using the Bootstrap script, after checking the bootstrap I think is not worth to use it in the AWS deployment, only generates a couple of extra files...
also I fix the block codes from js to
json
from docs.
Thanks for opening this issue!
- π We are excited about your ideas for improvement!
from docs.
I think I mess up my installation because I did install parse-server from npm and also I did run the bootstrap file, and I think I have 2 parse servers,
Where did you see an instruction to execute both?
Looking at the Parse Server README I see only this:
$ npm install -g parse-server mongodb-runner
$ mongodb-runner start
$ parse-server --appId APPLICATION_ID --masterKey MASTER_KEY --databaseURI mongodb://localhost/test
from docs.
I haven't see both in the same place, I saw the npm version in the README and the Bootstrap version in the Docs Getting Started Section.
Use the bootstrap script to set up Parse Server in the current directory.
I assumed? that maybe the npm was some library that parse-server needed and the "official" parse server installation was the Bootstrap version that maybe also installed the npm... π€·ββοΈ
Or maybe I thought that the npm was 'the one' and the Bootstrap was the parse-server I need to clone/fork to contribute to the project π€·ββοΈ I just installed bothπ€¦ββοΈ
To be honest, no idea what is the difference, are they the same?
from docs.
The bootstrap script installs parse server - and more. You can take a look at the script to see whether it's useful for you. The npm i -g parse-server
installs parse server globally, which makes it accessible from anywhere in the CLI but may make it more difficult for Parse Server development when switching between versions of Parse Server frequently.
What is right for you depends on what you want to do. Either guide works, but with different implications.
I agree that this may seem confusing for new developers who are just getting started with Node.js development. A proper guide should consolidate and offer both approaches to set up Parse Server and explain the differences. But it doesn't make any sense to duplicate that information in the README and the docs. The README should be stripped of all docs-like content and that content should move into the docs.
If you want to look more into this, see the npm docs link I posted above and study the bootstrap script to see what it does. It may be a bit of work, but the learning and insight should be worth it. And maybe you want to open a PR afterwards to improve the docs in that regard.
from docs.
I agree 100% that the README (and the wiki) should not contain any doc related stuff... I am gonna try to dig into those 2 options and edit the AWS Deployment Guide (it states to do both installs)...
probably more questions will pop in my head, should I come back here? or use Slack??
from docs.
Related Issues (20)
- π Change block codes format to jsonc
- π Fix json example HOT 1
- π Navigation links in the API page are broken HOT 5
- π Wrong link to the API Reference in JavaScript block HOT 1
- π Improving Parse Server AWS guide
- π Refurbishment of Python code examples HOT 3
- Endpoint `loginAs` is falsely documented to require GET request HOT 6
- Remove forms that request sensitive information
- Parse Server Option `enforcePrivateUsers` not documented HOT 3
- π Remove reference to `{ usePost: true }` option in login documentation
- π Examples section with end to end tutorial HOT 6
- π How to use Defined Schema on existing Parse Server installation
- Update to PS6 π
- Create Rate Limit docsπ
- Create auth adapter docs
- Fix docs page HOT 6
- Documentation HOT 2
- π
- πProvide information on using Facebook's Limited Token
- π Missing examples throughout the docs HOT 2
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
π Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. πππ
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google β€οΈ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from docs.