Skip to content

Commit

Permalink
docs: tweak readme docs
Browse files Browse the repository at this point in the history
  • Loading branch information
ghiscoding committed Dec 18, 2021
1 parent 4986f99 commit e89ba3e
Show file tree
Hide file tree
Showing 9 changed files with 20 additions and 19 deletions.
8 changes: 5 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,8 +31,8 @@ You might be wondering why was this monorepo created? Here are a few of the reas
- you can use it in plain JavaScript (ES6) or TypeScript, on our side we use it with plain JS (ES6) in our Salesforce environment with LWC (Lightning Web Component)

### Frameworks using this monorepo
- [Aurelia-Slickgrid](https://github.com/ghiscoding/aurelia-slickgrid) starting with version `3.x` is now using Slickgrid-Universal
- [Angular-Slickgrid](https://github.com/ghiscoding/Angular-Slickgrid) starting with version `3.x` is now using Slickgrid-Universal
- [Aurelia-Slickgrid](https://github.com/ghiscoding/aurelia-slickgrid) starting with version `>=3.x` is now using Slickgrid-Universal
- [Angular-Slickgrid](https://github.com/ghiscoding/Angular-Slickgrid) starting with version `>=3.x` is now using Slickgrid-Universal
- [Vanilla bundle](https://github.com/ghiscoding/slickgrid-universal/tree/master/packages/vanilla-bundle) is to use it with plain JavaScript or TypeScript without targeting any particular framework.

The Vanilla Implementation (not associated to any framework) is built with [WebPack](https://webpack.js.org/) and is also used to test all the UI functionalities [Cypress](https://www.cypress.io/) (E2E tests). The [Vanilla-force-bundle](https://github.com/ghiscoding/slickgrid-universal/tree/master/packages/vanilla-bundle), which extends the `vanilla-bundle` package is what we use in our SalesForce implementation (with Lightning Web Component), hence the creation of this monorepo library.
Expand Down Expand Up @@ -70,7 +70,9 @@ Slickgrid-Universal has **100%** Unit Test Coverage, we are talking about +15,00
| [@slickgrid-universal/vanilla-force-bundle](https://github.com/ghiscoding/slickgrid-universal/tree/master/packages/vanilla-force-bundle) | [![npm](https://img.shields.io/npm/v/@slickgrid-universal/vanilla-force-bundle.svg?color=forest)](https://www.npmjs.com/package/@slickgrid-universal/vanilla-force-bundle) | Vanilla TypeScript/ES6 for Salesforce implementation | [changelog](https://github.com/ghiscoding/slickgrid-universal/blob/master/packages/vanilla-force-bundle/CHANGELOG.md)

## Installation
To get going and do development with this monorepo, you will need to clone the repo and then follow the steps below
**NOTE:** the installation instructions below are **only** required if you want to contribute to this project, if on the other hand you just want to use Slickgrid-Universal then take a look at [webpack-demo-vanilla-bundle](https://github.com/ghiscoding/slickgrid-universal/tree/master/examples/webpack-demo-vanilla-bundle)

To get going and do development with this monorepo, you will need to clone the repo and then follow the steps below.

1. Install npm packages with [Yarn classic 1.x](https://classic.yarnpkg.com/lang/en/) since this lib uses Yarn version 1.x Workspaces and so you need to use Yarn to install all packages
```bash
Expand Down
9 changes: 4 additions & 5 deletions packages/common/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,17 +12,16 @@
## Common Filters/Editors/Extensions/Services
#### @slickgrid-universal/common

This package is regrouping the most common features or pieces that could be used by any other Framework (it is framework agnostic). It includes all Editors, Filters, Extensions and Services as can be seen below.
This package is regrouping the most common features, extensions, interfaces that can be used by other Frameworks (it is framework agnostic). It includes all Editors, Filters, Formatters, Grouping, Extensions and Services as can be seen below.

### Installation
Go to the root of the repo and follow the instructions provided in the main [README](https://github.com/ghiscoding/slickgrid-universal#installation)

### What is included?
- **Aggregators** (min, max, avg, sum, ...)
- **Editors** (input, singleSelect, multipleSelect, date, slider, ...)
- **Filters** (input, singleSelect, multipleSelect, date, slider, ...)
- **Formatters** (date formats, decimal, dollars, percent, bold, checkmark, ...)
- **Editors & Filters** (input, singleSelect, multipleSelect, date, slider, ...)
- **Extensions** (SlickGrid 3rd party controls/plugins)
- **Formatters** (date formats, decimal, dollars, percent, bold, checkmark, ...)
- **Grouping** Formatters (min, max, avg, sum, ...)
- **SortComparers** (date, numeric, string, ...)
- **Services** (filter, sort, grid state, ...)
- **SortComparers** (date, numeric, string, ...)
2 changes: 1 addition & 1 deletion packages/composite-editor-component/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
Vanilla Bundle implementation of a Composite Editor Modal Window which can do the following
- Create
- Clone (allows you to clone & edit a row, it's like a copy+edit in a single action)
- Update
- Edit / Update
- Mass Update Changes
- Mass Selection Changes (similar to Mass Update but only for the selected items/rows)

Expand Down
4 changes: 2 additions & 2 deletions packages/excel-export/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
## Excel Export Service
#### @slickgrid-universal/excel-export

Simple Export to Excel Service that allows to exporting as ".xls" or ".xlsx".
Simple Export to Excel Service that allows to exporting as `.xls` or `.xlsx`.

### Internal Dependencies
- [@slickgrid-universal/common](https://github.com/ghiscoding/slickgrid-universal/tree/master/packages/common)
Expand All @@ -21,7 +21,7 @@ Simple Export to Excel Service that allows to exporting as ".xls" or ".xlsx".
This package requires [excel-builder-webpacker](https://www.npmjs.com/package/excel-builder-webpacker) which itself requires [jszip](https://www.npmjs.com/package/jszip) and [lodash](https://www.npmjs.com/package/lodash), the later not being a small lib, so make sure that you are fine with the bundle size. For our use case, the extra bundle size is totally worth the feature.

### Installation
Follow the instruction provided in the main [README](https://github.com/ghiscoding/slickgrid-universal#installation), you can see a demo by looking at the [GitHub Demo](https://ghiscoding.github.io/slickgrid-universal) page and click on "Export to CSV" from the Grid Menu (aka hamburger menu).
Follow the instruction provided in the main [README](https://github.com/ghiscoding/slickgrid-universal#installation), you can see a demo by looking at the [GitHub Demo](https://ghiscoding.github.io/slickgrid-universal) page and click on "Export to Excel" from the Grid Menu (aka hamburger menu).

### Usage
In order to use the Service, you will need to register it in your grid options via the `registerExternalResources` as shown below.
Expand Down
2 changes: 1 addition & 1 deletion packages/odata/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ export class MyExample {
backendServiceApi: {
service: new GridOdataService(),
options: {
version: 4 // OData v4
version: 4 // OData v2 or v4
},
preProcess: () => this.displaySpinner(true),
process: (query) => this.getCustomerApiCall(query),
Expand Down
2 changes: 1 addition & 1 deletion packages/rxjs-observable/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@

An RxJS Observable Service Wrapper to make it possible to use RxJS with Slickgrid-Universal (with a Backend Service like OData/GraphQL). By default any Backend Service will be using Promises unless we use this RxJS Observable package.

This package is simply a bridge, a facade, to make it possible to use RxJS without adding RxJS to the `@slickgrid-universal/common` list of dependencies, so RxJS is a dependency of this package without being a dependency of the common (core) package, This will avoid adding dependencies not everyone need and won't clutter the common package (the common package will simply use an empty interface, which won't do anything, without requiring to install RxJS at all. We do however have full unit tests coverage for all of that).
This package is simply a bridge, a facade, to make it possible to use RxJS without adding RxJS to the `@slickgrid-universal/common` list of dependencies, so RxJS is a dependency of this package without being a dependency of the common (core) package, This will avoid adding dependencies not everyone need and won't clutter the common package (the common package will simply use an empty interface, which won't do anything, without requiring to install RxJS at all. We also have full unit tests coverage for all of that).

### Internal Dependencies
- [@slickgrid-universal/common](https://github.com/ghiscoding/slickgrid-universal/tree/master/packages/common)
Expand Down
6 changes: 3 additions & 3 deletions packages/text-export/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,11 +12,11 @@
## Text Export Service (text file)
#### @slickgrid-universal/text-export

Simple Export to File Service that allows to export as CSV or Text, user can also choose which separator to use (comma, colon, semicolon, ...).
Simple Export to File Service that allows to export as CSV or Text (`.csv` or `.txt`), user can also choose which data separator to use for the export (comma, colon, semicolon, ...).

There are a couple of reasons to use this package (instead of the `excel-export`)
There are a couple of reasons to use this package (it could be used instead of the `excel-export`)
- if you want to export to a text file with any type of separator (tab, colon, semicolon, comma)
- if you have a very large dataset, this export consumes a lot less memory compare to the `excel-export`
- if you have a very large dataset, this export consumes a lot less memory in comparison to the `excel-export`

### Internal Dependencies
- [@slickgrid-universal/common](https://github.com/ghiscoding/slickgrid-universal/tree/master/packages/common)
Expand Down
2 changes: 1 addition & 1 deletion packages/vanilla-bundle/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
## Vanilla Bundle
#### @slickgrid-universal/vanilla-bundle

Vanilla Bundle implementation (no framework, plain TypeSript implementation). This package does what other framework would do, that is to make all the features usable in 1 bundle so that it could then be used by other Apps/Projects
Vanilla Bundle implementation (no framework, plain TypeSript implementation). This package does what other framework would do which is to make all these features usable into 1 bundle so that it could then be used by other Apps/Projects.

### Internal Dependencies
- [@slickgrid-universal/common](https://github.com/ghiscoding/slickgrid-universal/tree/master/packages/common)
Expand Down
4 changes: 2 additions & 2 deletions packages/vanilla-force-bundle/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,12 +12,12 @@
## Vanilla Force Bundle
#### @slickgrid-universal/vanilla-force-bundle

Vanilla Force Bundle is similar to the Vanilla Bundle but oriented towards a Salesforce (LWC) implementation which requires an all-in-1 bundle (zip) with all necessary package loaded at once. So this package is very similar to the [@slickgrid-universal/vanilla-bundle](https://github.com/ghiscoding/slickgrid-universal/tree/master/packages/vanilla-bundle), it actually extends it, with the difference that it adds and imports 3 extra packages (which are optional in the `vanilla-bundle` but required for our Salesforce implementation) and those are:
Vanilla Force Bundle is similar to the Vanilla Bundle but oriented towards a Salesforce (LWC) implementation which requires an all-in-1 bundle (zip) with all necessary package loaded at once. So this package is very similar to the [@slickgrid-universal/vanilla-bundle](https://github.com/ghiscoding/slickgrid-universal/tree/master/packages/vanilla-bundle), it actually extends from it, with the only difference that it imports and includes 3 extra packages (which are optional in the `vanilla-bundle` but required for our Salesforce implementation) and those are:
- CompositeEditor
- CustomTooltip
- TextExport (CSV))

This package does what other framework would do, that is to make all the features usable in 1 bundle so that it could then be used by other Apps/Projects, for example we use this bundle in our SalesForce (with Lighning Web Component) App and it requires plain ES6 JavaScript which this bundle also produce (for that there's a [dist-grid-bundle-zip](https://github.com/ghiscoding/slickgrid-universal/tree/master/packages/vanilla-force-bundle/dist-grid-bundle-zip) folder which will zip the ES6 `dist` folder which we then import in SalesForce as a static resource).
This package does what other framework would do, that is to make all the features usable into 1 bundle so that it could then be used by other Apps/Projects, for example we use this bundle in our SalesForce (with Lighning Web Component) App and it requires plain ES6 JavaScript which this bundle also produce (for that there's a [dist-grid-bundle-zip](https://github.com/ghiscoding/slickgrid-universal/tree/master/packages/vanilla-force-bundle/dist-grid-bundle-zip) folder which will zip the ES6 `dist` folder which we then import in our SalesForce implementation as a static resource).

### Internal Dependencies
- [@slickgrid-universal/common](https://github.com/ghiscoding/slickgrid-universal/tree/master/packages/common)
Expand Down

0 comments on commit e89ba3e

Please sign in to comment.