Skip to content

Commit 374e2cb

Browse files
cal-smithGitHub Enterprise
authored andcommitted
Merge pull request #5 from callums/master
Update/delete readmes
2 parents af93d61 + 428d010 commit 374e2cb

File tree

11 files changed

+27297
-27478
lines changed

11 files changed

+27297
-27478
lines changed

.travis.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,5 +16,5 @@ deploy:
1616
provider: script
1717
script: bash ./scripts/deploy.sh
1818
on:
19-
all_branches: true
19+
branch: master
2020
repo: ibm/carbon-components-angular

README.md

Lines changed: 15 additions & 63 deletions
Original file line numberDiff line numberDiff line change
@@ -1,56 +1,16 @@
1-
# Neutrino
2-
A componentized _Angular_ implementation of the Watson Customer Engagement design guide.
1+
# Carbon Components Angular
2+
An _Angular_ implementation of the Carbon Design System
33

44
### Getting started
55

6-
To quickly start developing new apps or demos, use
7-
<a href="https://github.ibm.com/peretz/neutrino-seed">
86
```
9-
__ _ _ __ _
10-
/\ \ \___ _ _| |_ _ __(_)_ __ ___ / _\ ___ ___ __| |
11-
/ \/ / _ \ | | | __| '__| | '_ \ / _ \ \ \ / _ \/ _ \/ _` |
12-
/ /\ / __/ |_| | |_| | | | | | | (_) | _\ \ __/ __/ (_| |
13-
\_\ \/ \___|\__,_|\__|_| |_|_| |_|\___/ \__/\___|\___|\__,_|
7+
$ npx @angular/cli new my-project
8+
$ cd my-project
9+
$ npm i carbon-components-angular carbon-components
10+
$ # include carbon css
11+
$ # import components
12+
$ npm start
1413
```
15-
</a>
16-
17-
Follow instructions in [Neutrino Seed repo](https://github.ibm.com/peretz/neutrino-seed) and use the rest of this readme if you need more detailed information.
18-
<a href="https://pages.github.ibm.com/peretz/neutrino/documentation">
19-
```
20-
___ _ _ _
21-
/ \___ ___ _ _ _ __ ___ ___ _ __ | |_ __ _| |_(_) ___ _ __
22-
/ /\ / _ \ / __| | | | '_ ` _ \ / _ \ '_ \| __/ _` | __| |/ _ \| '_ \
23-
/ /_// (_) | (__| |_| | | | | | | __/ | | | || (_| | |_| | (_) | | | |
24-
/___,' \___/ \___|\__,_|_| |_| |_|\___|_| |_|\__\__,_|\__|_|\___/|_| |_|
25-
```
26-
</a>
27-
28-
#### Artifactory
29-
30-
Run the following to add the needed information
31-
to your `~/.npmrc`. Replace `[email protected]` with your actual IBM email address and use your w3id password to
32-
authenticate when asked.
33-
34-
```bash
35-
curl [email protected] https://na.artifactory.swg-devops.com/artifactory/api/npm/wce-peretz-npm-local/auth/peretz >> ~/.npmrc
36-
```
37-
38-
##### Can't use `curl`?
39-
40-
In case if you don't wanna use curl command to setup the config in .npmrc file, here are the alternative steps. (Specially for Windows users):
41-
42-
1) Login to this page with your w3id credentials
43-
https://na.artifactory.swg-devops.com/artifactory/webapp/#/home
44-
2) Go to home page
45-
3) on the *set me up* card, type 'peretz' into the search box
46-
4) click on wce-peretz-npm-local
47-
5) A dialog will appear, in that Add your credentials at the top right corner
48-
6) Inside the same dialog, there is a section _using basic authentication_ copy and paste the same info in your `.npmrc` file _(in Windows `%USERPROFILE%/.npmrc`)_
49-
7) save your changes and try npm update
50-
51-
##### Getting errors?
52-
53-
If you recently changed you w3id password, you'll get an error like `npm ERR! 403 Forbidden: @peretz/neutrino@...` and you will have to update your `~/.npmrc` by retaking the "Artifactory" step. Remove references to `peretz` from it before, or delete the whole file if you can (i.e. if peretz libraries are only thing you use from artifactory).
5414

5515
#### Bundler
5616

@@ -72,7 +32,7 @@ Then you'll be able to `npm install @peretz/neutrino` and `npm install @peretz/m
7232
- **if you are contributing a fix**:
7333
- add your fix, update the documentation as needed
7434
- consider adding or modifying a test case to cover the fix
75-
- follow the [Neutrino style guide](https://github.ibm.com/peretz/neutrino/wiki/Style-guide), [Angular style guide](https://angular.io/styleguide) and [our general component guidelines](https://github.ibm.com/peretz/neutrino/wiki/General-component-API-guidelines)
35+
- follow the [Angular style guide](https://angular.io/styleguide)
7636
- be sure to run `npm test` and `npm run lint` to make sure the tests and linter pass
7737
- DO NOT change the version number.
7838
- submit a PR
@@ -101,30 +61,27 @@ Then you'll be able to `npm install @peretz/neutrino` and `npm install @peretz/m
10161
- current behaviour
10262
- screenshots if needed
10363
- relevant code snippets
104-
- links to application source code or running demo (including connection/authentication information)
64+
- links to application source code or running demo ([Codesandbox is awesome for this!](https://codesandbox.io/s/angular)) (including connection/authentication information)
10565
- add relevant labels (bug, accsibility, design, discussion, feature, etc)
10666
- if you have a fix to contribute, assign yourself, otherwise leave unassigned
10767

10868
#### npm commands
109-
To keep our build dependancies local we use npm scripts to run our webpack, gulp, and general build tasks. You should never install webpack or gulp globally as that will likely conflict with our version. You should never need to modify the build process to add a component or demo.
110-
- `npm run demo:server` to run the demo server (port 9000)
111-
- `npm run demo:build` to build the demo
69+
To keep our build dependancies local we use npm scripts to run our webpack, gulp, and general build tasks. You should never install webpack or gulp globally as that will likely conflict with our version. You should never need to modify the build process to add a component or story.
70+
- `npm run storybook` to run storybook (port 6006)
11271
- `npm run build` to generate the dist
11372
- `docs:build` to build documentation
11473
- `docs:server` to build and run the documentation server
11574
- `npm run lint` to run tslint
11675
- `npm test` to run tests
11776

11877
### Resources
119-
- [Neutrino style guide](https://github.ibm.com/peretz/neutrino/wiki/Style-guide)
120-
- [General component API guidelines](https://github.ibm.com/peretz/neutrino/wiki/General-component-API-guidelines)
78+
- [Style guide (WIP)](#)
79+
- [General component API guidelines (WIP)](#)
12180
- [Angular style guide](https://angular.io/styleguide)
12281
- [I18N tooling](https://angular.io/docs/ts/latest/cookbook/i18n.html)
12382
- (Angular 2+ doesn't have anything like ngAria, instead here's [The A11Y Project](http://a11yproject.com/), [WAI-ARIA specs](https://www.w3.org/TR/wai-aria/), and [WAI-ARIA Authoring Practices](https://www.w3.org/TR/2016/WD-wai-aria-practices-1.1-20160317/))
124-
- [CDL master files and microguides (May 2018)](https://ibm.box.com/v/May2018MasterfileMicroguidePDF)
12583
- [TypeScript docs](https://www.typescriptlang.org/docs/tutorial.html)
126-
- [Dynamic Assessment Plugin (aka. DAP/RPT)](https://w3-connections.ibm.com/wikis/home?lang=en-us#!/wiki/W88ee03f8907c_412b_a3a8_988dabb72b35/page/Dynamic%20Assessment%20Plugin) - now shipping a pretty solid chrome plugin
127-
- [CDL Icon Library](https://icon.stage1.mybluemix.net/) - Note only the icons in the "MASTER SET" sets are maintained
84+
12885

12986
### Philosophy
13087
- Components should be the smallest unit of computation
@@ -137,8 +94,3 @@ To keep our build dependancies local we use npm scripts to run our webpack, gulp
13794
- Likewise, stateless components should be favored whenever possible
13895
- Components should NOT *necessarily* implement the style guide point-for-point, the guide simply provides guidance on overarching functionality, components should enable that and product specific designs **without** baking in extra functionality
13996

140-
### Contact
141-
142-
[Send feedback](https://peretz.slack.com/messages/C6DS43Y5N)
143-
144-
[Ask a question](https://peretz.slack.com/messages/C6DS43Y5N)

0 commit comments

Comments
 (0)