Skip to content

Commit 4266b34

Browse files
authored
Merge pull request #2 from typescript-package/develop
docs(README.md): update.
2 parents 5280e57 + 598c8ca commit 4266b34

File tree

1 file changed

+97
-37
lines changed

1 file changed

+97
-37
lines changed

README.md

Lines changed: 97 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -1,63 +1,123 @@
1-
# Affix
1+
<a href="https://www.typescriptlang.org/">
2+
<img
3+
src="https://avatars.githubusercontent.com/u/189666396?s=150&u=9d55b1eb4ce258974ead76bf07ccf49ef0eb0ea7&v=4"
4+
title="@typescript-package/affix"
5+
/>
6+
</a>
27

3-
This project was generated using [Angular CLI](https://github.com/angular/angular-cli) version 19.0.0.
8+
## typescript-package/affix
49

5-
## Code scaffolding
10+
<!-- npm badge -->
11+
[![npm version][typescript-package-npm-badge-svg]][typescript-package-npm-badge]
12+
[![GitHub issues][typescript-package-badge-issues]][typescript-package-issues]
13+
[![GitHub license][typescript-package-badge-license]][typescript-package-license]
614

7-
Angular CLI includes powerful code scaffolding tools. To generate a new component, run:
15+
A **lightweight** TypeScript library for the affix - prefix and suffix.
16+
17+
<br>
18+
19+
## Table of contents
20+
21+
- [Installation](#installation)
22+
- [Api](#api)
23+
- [Contributing](#contributing)
24+
- [Support](#support)
25+
- [Code of Conduct](#code-of-conduct)
26+
- [Git](#git)
27+
- [Commit](#commit)
28+
- [Versioning](#versioning)
29+
- [License](#license)
30+
31+
## Installation
832

933
```bash
10-
ng generate component component-name
34+
npm install @typescript-package/affix --save-peer
1135
```
1236

13-
For a complete list of available schematics (such as `components`, `directives`, or `pipes`), run:
37+
## Api
1438

15-
```bash
16-
ng generate --help
39+
```typescript
40+
import {
41+
Affix,
42+
Prefix,
43+
Suffix
44+
} from '@typescript-package/affix';
1745
```
1846

19-
## Building
47+
## Contributing
2048

21-
To build the library, run:
49+
Your contributions are valued! If you'd like to contribute, please feel free to submit a pull request. Help is always appreciated.
2250

23-
```bash
24-
ng build affix
25-
```
51+
## Support
2652

27-
This command will compile your project, and the build artifacts will be placed in the `dist/` directory.
53+
If you find this package useful and would like to support its and general development, you can contribute through one of the following payment methods. Your support helps maintain the packages and continue adding new.
2854

29-
### Publishing the Library
55+
Support via:
3056

31-
Once the project is built, you can publish your library by following these steps:
57+
- [Stripe](https://donate.stripe.com/dR614hfDZcJE3wAcMM)
58+
- [Revolut](https://checkout.revolut.com/pay/048b10a3-0e10-42c8-a917-e3e9cb4c8e29)
3259

33-
1. Navigate to the `dist` directory:
34-
```bash
35-
cd dist/affix
36-
```
60+
Thanks for your support!
3761

38-
2. Run the `npm publish` command to publish your library to the npm registry:
39-
```bash
40-
npm publish
41-
```
62+
## Code of Conduct
4263

43-
## Running unit tests
64+
By participating in this project, you agree to follow **[Code of Conduct](https://www.contributor-covenant.org/version/2/1/code_of_conduct/)**.
4465

45-
To execute unit tests with the [Karma](https://karma-runner.github.io) test runner, use the following command:
66+
## GIT
4667

47-
```bash
48-
ng test
49-
```
68+
### Commit
5069

51-
## Running end-to-end tests
70+
- [AngularJS Git Commit Message Conventions][git-commit-angular]
71+
- [Karma Git Commit Msg][git-commit-karma]
72+
- [Conventional Commits][git-commit-conventional]
5273

53-
For end-to-end (e2e) testing, run:
74+
### Versioning
5475

55-
```bash
56-
ng e2e
57-
```
76+
[Semantic Versioning 2.0.0][git-semver]
77+
78+
**Given a version number MAJOR.MINOR.PATCH, increment the:**
79+
80+
- MAJOR version when you make incompatible API changes,
81+
- MINOR version when you add functionality in a backwards-compatible manner, and
82+
- PATCH version when you make backwards-compatible bug fixes.
83+
84+
Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.
85+
86+
**FAQ**
87+
How should I deal with revisions in the 0.y.z initial development phase?
88+
89+
> The simplest thing to do is start your initial development release at 0.1.0 and then increment the minor version for each subsequent release.
90+
91+
How do I know when to release 1.0.0?
92+
93+
> If your software is being used in production, it should probably already be 1.0.0. If you have a stable API on which users have come to depend, you should be 1.0.0. If you’re worrying a lot about backwards compatibility, you should probably already be 1.0.0.
94+
95+
## License
96+
97+
MIT © angular-package ([license][typescript-package-license])
98+
99+
<!-- This package: typescript-package -->
100+
<!-- GitHub: badges -->
101+
[typescript-package-badge-issues]: https://img.shields.io/github/issues/typescript-package/affix
102+
[typescript-package-badge-forks]: https://img.shields.io/github/forks/typescript-package/affix
103+
[typescript-package-badge-stars]: https://img.shields.io/github/stars/typescript-package/affix
104+
[typescript-package-badge-license]: https://img.shields.io/github/license/typescript-package/affix
105+
<!-- GitHub: badges links -->
106+
[typescript-package-issues]: https://github.com/typescript-package/affix/issues
107+
[typescript-package-forks]: https://github.com/typescript-package/affix/network
108+
[typescript-package-license]: https://github.com/typescript-package/affix/blob/master/LICENSE
109+
[typescript-package-stars]: https://github.com/typescript-package/affix/stargazers
110+
<!-- This package -->
58111

59-
Angular CLI does not come with an end-to-end testing framework by default. You can choose one that suits your needs.
112+
<!-- Package: typescript-package -->
113+
<!-- npm -->
114+
[typescript-package-npm-badge-svg]: https://badge.fury.io/js/%40typescript-package%2Faffix.svg
115+
[typescript-package-npm-badge]: https://badge.fury.io/js/%40typescript-package%2Faffix
60116

61-
## Additional Resources
117+
<!-- GIT -->
118+
[git-semver]: http://semver.org/
62119

63-
For more information on using the Angular CLI, including detailed command references, visit the [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli) page.
120+
<!-- GIT: commit -->
121+
[git-commit-angular]: https://gist.github.com/stephenparish/9941e89d80e2bc58a153
122+
[git-commit-karma]: http://karma-runner.github.io/0.10/dev/git-commit-msg.html
123+
[git-commit-conventional]: https://www.conventionalcommits.org/en/v1.0.0/

0 commit comments

Comments
 (0)