Skip to content

Commit afcab99

Browse files
author
Imtiyaz-CHOUJAI
committed
Fix issues with docs
1 parent 4281122 commit afcab99

11 files changed

+38
-40
lines changed

docs/authentication.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,17 +2,17 @@
22
!!! tip
33
It's recommended to take a look at the firebase authentication docs, please check the following link[firebase auth docs](https://firebase.google.com/docs/auth/web/start).
44

5-
How hard it is to integrate **Firebase auth** to your web project especially when you try to structure and organize firebase auth globally to be used through all **Vue components**.
5+
How hard it is to integrate **Firebase auth** to your web project especially when you try to structure and organize firebase auth globally to be used through all your **Vue components**.
66

7-
Thanks to **Myfirebase auth system** which makes firebase auth easier to be managed using **Vuex**, the fireabse auth is injected and triggered at beginning of the Vue instance.
7+
Thanks to **Myfirebase auth system** it makes firebase auth easier to be managed using **Vuex**, its injected and triggered at beginning of the Vue instance.
88

99
<hr>
1010

1111
#### Auth instance
1212

1313
Syntax : `$auth`
1414

15-
`$auth` is a global auth instance which called through Vue component.
15+
`$auth` is a global auth instance which is called through the Vue component.
1616

1717
##### Example
1818

@@ -84,7 +84,7 @@ Syntax : `$auth.getUser()`
8484
You can update profile avatar usign `updateProfilePicture(object)` method, this will update the default firebase user **profileURL**.
8585

8686
!!! tip
87-
Before you start updating profile picture, make sure that you have uploaded that picture to firebase storage, and get photoURL, see [Upload a file with Myfirebase]().
87+
Before you start updating profile pictures, make sure that you have uploaded that picture to firebase storage, and got photoURL, see [Upload a file with Myfirebase]().
8888

8989
Syntax : `$auth.updateProfilePicture(String)`
9090
Return : `Promise`
@@ -121,7 +121,7 @@ Return : `Promise`
121121
Syntax : `$auth.state(String, String)`
122122
Return : `Promise`
123123

124-
Consider it just like an auth middleware where you can check if the user is signed in or not, you can also redirect the user to another component if he doesn't sign in.
124+
Consider it just like an auth middleware where you can check if the user is signed in or not, you can also redirect the user to another component if he is not signed in.
125125

126126
##### Example
127127

@@ -202,7 +202,7 @@ Return : `Promise`
202202

203203
#### Signup with email and password
204204

205-
To register a new user with email and password.
205+
To register a new user with an email and password.
206206

207207
Synax : `$auth.registerWithEmailAndPassword()`
208208
Return : `Promise`
@@ -252,7 +252,7 @@ Return : `Promise`
252252

253253
#### SignIn with email and password
254254

255-
To sign in a user with email and passowrd.
255+
To sign in a user with an email and passowrd.
256256

257257
Syntax : `$auth.loginWithEmailAndPassword(String, String)`
258258
Return : `Promise`
@@ -304,7 +304,7 @@ Return : `Promise`
304304

305305
#### SignIn with google
306306

307-
Allow the users to authenticate to Firebase using their **Google accounts**.
307+
Allow users to authenticate to Firebase using their **Google accounts**.
308308

309309
Syntax : `$auth.signInWithGoogle()`
310310
Return : `Promise`
@@ -353,7 +353,7 @@ Return : `Promise`
353353

354354
#### SignIn with Facebook
355355

356-
Allow the users to authenticate to Firebase using their **Facebook Accounts**.
356+
Allow users to authenticate to Firebase using their **Facebook Accounts**.
357357

358358
Syntax : `$auth.signInWithFacebook()`
359359
Return : `Promise`
@@ -362,7 +362,7 @@ Return : `Promise`
362362

363363
#### SignIn with Twitter
364364

365-
Allow the users to authenticate to Firebase using their **Twitter Accounts**.
365+
Allow users to authenticate to Firebase using their **Twitter Accounts**.
366366

367367
Syntax : `$auth.signInWithTwitter()`
368368
Return : `Promise`
@@ -371,7 +371,7 @@ Return : `Promise`
371371

372372
#### SignIn with Github
373373

374-
Allow the users to authenticate to Firebase using their **Github Accounts**.
374+
Allow users to authenticate to Firebase using their **Github Accounts**.
375375

376376
Syntax : `$auth.signInWithGithub()`
377377
Return : `Promise`

docs/cloud-functions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,4 +60,4 @@ exports.sendMessageNotification = functions.database.ref('data/{messageID}').onW
6060
As you can see it's easy to write functions with firebase cloud functions.
6161

6262
!!! info "Firebase cloud messaging"
63-
This example of sending push notification requires registering a service-worker through client site (browser) which is already defined in this project, check the following link [Cloud Messaging](cloud-messaging.md).
63+
This example of sending push notification requires registering a service-worker through the client site (browser) which is already defined in this project, check the following link [Cloud Messaging](cloud-messaging.md).

docs/cloud-messaging.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,4 @@ messaging.setBackgroundMessageHandler(function(payload) {
4040

4141
```
4242

43-
This service worker will handle notification messages even in the background when the user is not opening the browser.
44-
45-
To send a notification message to a client you could write your logic through a single firebase cloud function, we already have an example, check the following link [Cloud functions](cloud-functions.md).
43+
This service worker will handle notification messages even in the background when the users browser is not opened the .

docs/components.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
1-
At the high level, components are custom elements that Vue compiler would attach specified behavior too. They contain your HTML, scripts, and stylesheets at the same time in one file.
1+
A little advanced, components are custom elements that Vue compiler would attach specified behaviors too. They contain your HTML, scripts, and stylesheets at the same time all in one file.
22

33
They are located in the `/src/components/` directory.
44

5-
To create a new component you could run `new:component command` in your terminal.
5+
To create a new component you need to run `new:component command` in your terminal.
66

7-
`myfirebase new:component <component-name>`, the Myfirebase-CLI will generate a new component and put it inside your application `/src/components/<component-name>.vue`.
7+
`myfirebase new:component <component-name>`, the Myfirebase-CLI will generate a new component and place it inside your components directory `/src/components/<component-name>.vue`.
88

99
A simple component might look something like this:
1010

docs/directory-structure.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
By default, Myfirebase application structure provides a great starting point for your application. However, you are free to organize your files/directories as you like.
1+
By default, Myfirebases structure provides a great starting point for your application. However, you are free to organize your files/directories as you like.
22

33
#### Root Directory
44

@@ -27,18 +27,18 @@ For sure, you are free to define and organize this directory structure however y
2727
!!! tip "Firebase Cloud functions docs"
2828
New to firebase?, please see [Firebase Cloud functions docs](https://firebase.google.com/docs/functions/).
2929

30-
Firebase cloud functions directory, where the cloud functions are located, in this directory you could write some back-end functions to handle cloud messaging and business logic if necessary and a lot of advanced stuff.
30+
In the firebase cloud functions directory,you can write some back-end functions to handle cloud messaging and business logic if necessary and a lot of advanced stuff.
3131

3232
!!! tip "Google Cloud Platform"
33-
It's become easier to integrate some advanced kinds of stuff such as machine learning and image processing with [Google Cloud Platform](https://cloud.google.com).
33+
It's become easier to integrate some advanced technologies such as machine learning and image processing with [Google Cloud Platform](https://cloud.google.com) and more.
3434

3535
#### `/storage`
3636

3737
The storage directory contains all of your storage files, using one of Vuejs eco-system, see [Vuex](https://vuex.vuejs.org/en/).
3838

3939
#### `/public`
4040

41-
Public directory contains the main index.html file, this directory also houses all of your application compiled assets CSS, JS files and service-workers as well, **these assets will be auto injected to index.html**
41+
The public directory contains the main index.html file, it also houses all of your applications compiled assets CSS, JS files and service-workers, **these assets will be auto injected to index.html**
4242

4343
!!! note "service workers"
4444
Google developers had made some cool articles about the service-worker concept, see [Service Workers: an Introduction](https://developers.google.com/web/fundamentals/getting-started/primers/service-workers).
@@ -59,16 +59,16 @@ Public directory contains the main index.html file, this directory also houses a
5959

6060
#### `/build`
6161

62-
Apparently, you may not touch anything right here, this directory contains all the **build** files managed by node.js unless you want to specify some of your additional configuration such as development server port, service-workers or even changing web pack configuration.
62+
Apparently, you may not want to touch anything right here, this directory contains all the **build** files managed by node.js unless you want to specify some of your additional configuration such as development server port, service-workers or even changing web pack configuration, then you may proceed.
6363

6464
#### `/config`
6565

6666
Where the development and the production mode configuration are located.
6767

6868
#### `/static`
6969

70-
Where static files are located, images and icons are used as a static assets into your applications.
70+
Where static files are located, images and icons are used as a static assets in your applications.
7171

7272
#### `/tests`
7373

74-
Where your application tests are located, by default Myfirebase comes with eslint and karma for unit testing, you are free to integrate others libraries and plugins such as [night watch](http://nightwatchjs.org/) e2e.
74+
Where your application tests are located, by default Myfirebase comes with eslint and karma for unit testing, you are free to integrate other libraries and plugins such as [night watch](http://nightwatchjs.org/) e2e.

docs/global-guard.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11

2-
As the name implies, the navigation guards provided by vue-router are primarily used to guard navigations either by redirecting it or canceling it. There are a number of ways to hook into the route navigation process: globally, per-route, or in-component.
2+
As the name implies, the navigation guards provided by vue-router are primarily used to guard navigation either by redirecting it or canceling it. There are a number of ways to hook into the route navigation process: globally, per-route, or in-component.
33

44
!!! warning
55
Remember that params or query changes won't trigger enter/leave navigation guards. You can either watch the $route object to react to those changes or use the beforeRouteUpdate in-component guard, see [vue-router global navigation guards](https://router.vuejs.org/en/advanced/navigation-guards.html).
@@ -8,7 +8,7 @@ As the name implies, the navigation guards provided by vue-router are primarily
88

99
#### Creating middleware
1010

11-
Myfirebase provides a simple way to create navigations guards or middlewares, you could simply run `myfirebase new:middleware <middleware-name>`. Myfirebase-cli will generate a middleware template for you located in `/src/middlewares/` directory.
11+
Myfirebase provides a simple way to create navigations guards or middlewares, you could simply run `myfirebase new:middleware <middleware-name>`. Myfirebase-cli will generate a middleware template for you located in the `/src/middlewares/` directory.
1212

1313
Typically, The middleware generated might look something like this:
1414

@@ -56,7 +56,7 @@ export default middlewares
5656

5757
#### Auth Middleware
5858

59-
Myfirebase comes with an example called AuthMiddleware located in middlewares directory, this will check if the user is signed-in or not, and be redirecting users to the login page.
59+
Myfirebase comes with an example called AuthMiddleware located in middlewares directory, this will check if the user is signed-in or not, and redirect users to the login page.
6060

6161
As you may notice, you will find in the **route.js** file a **metadata** called auth, which is assigned to **App** and **UpdateProfile** components.
6262

docs/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
<h3 align="center"><b>Myfirebase</b> <i>SPA Framework</i> Documentation</h3>
66

77
!!! info
8-
Welcome to Myfirebase docs, in this guide, we assume that you already familiar with [VueJs framework ecosystem](http://vuejs.org), [webpack](https://webpack.github.io/), [Firebase](https://firebase.google.com) and [node package manager](https://www.npmjs.com/).
8+
Welcome to Myfirebase docs, in this guide, we assume that you are already familiar with [VueJs framework ecosystem](http://vuejs.org), [webpack](https://webpack.github.io/), [Firebase](https://firebase.google.com) and [node package manager](https://www.npmjs.com/).
99

1010
**Myfirebase** Is a decoupled single page application framework which is highly compatible with [Google Firebase](https://firebase.google.com). It has some really cool features.
1111

docs/installation.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
#### Prerequisites
22

3-
1. **NPM** is the recommended installation method when building large-scaled applications with **Myfirebase**.
3+
1. **NPM** is the recommended installation method when building large-scale applications with **Myfirebase**.
44

5-
If this is the first time you want to give **npm** a shot, don't worry, we got exactly what you need.
5+
If this is the first time you are trying **npm** , don't worry, we'll guide you every step of the way.
66

77
- [How to Install Node.js and NPM on Windows](http://blog.teamtreehouse.com/install-node-js-npm-windows)
88

@@ -16,7 +16,7 @@
1616

1717
#### Installing Myfirebase
1818

19-
- Create new Myfirebase project via myfirebase-cli.
19+
- Create a new Myfirebase project via myfirebase-cli.
2020

2121
```shell
2222
# Create new project with myfirebase-cli

docs/routing.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,17 +7,17 @@ Myfirebase is using Vuejs routes system, all routes are located in `/src/routes/
77

88
By default, Myfirebase has some default routes already defined in `routes.js` file.
99

10-
- Layout.vue: which is the default layout of our application.
10+
- Layout.vue: which is the default layout of the application.
1111

12-
- Welcome.vue: which is a default welcoming component.
12+
- Welcome.vue: which is a default welcome component.
1313

1414
- Login.vue: which is responsible for authenticating users (register/login/logout) using firebase authentication.
1515

1616
- UpdateProfile.vue: which is responsible for updating user profile (email/password) and user avatar using firebase cloud storage.
1717

18-
- App.vue: which is the default component to start playing with the firebase database.
18+
- App.vue: which is the default component to manipulate the firebase database.
1919

20-
- Firestore.vue: which is the default component to start playing with the cloud firestore.
20+
- Firestore.vue: which is the default component to use the cloud firestore.
2121

2222
```javascript
2323

docs/storage.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ Myfirebase provides a simple way to interact with firebase storage via a global
77

88
Syntax : `$storage`
99

10-
`$auth` is a global auth instance which called through Vue component.
10+
`$auth` is a global auth instance which called through the Vue component.
1111

1212
<hr>
1313

@@ -23,7 +23,7 @@ You can retrieve firebase storage object using `get()` method.
2323

2424
Syntax : `$storage.getDownloadURL(object)`
2525

26-
You can get your file URL of the user avatar or document which stored through firebase storage using `getDownloadURL`.
26+
You can get the file URL of the user avatar or document which stored through firebase storage using `getDownloadURL`.
2727

2828
##### Example
2929

@@ -152,4 +152,4 @@ You can delete a file with `delete` method specifying the file path.
152152
}
153153
}
154154
</script>
155-
```
155+
```

docs/store.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
Myfirebase is using Vuex which is a simple scalable state management system compatible with Vuejs, all Myfirebase states are located in `/storage` directory.
1+
Myfirebase is using Vuex which is a simple scalable state management system compatible with Vuejs, all of Myfirebase states are located in `/storage` directory.
22

33
Storage directory houses `store.js`, `myfirebase-auth` and `myfirebase-storage`.
44

0 commit comments

Comments
 (0)