Skip to content

Commit 60f9c2e

Browse files
bactgoneall
authored andcommitted
Add Javadoc links to README
Add links to Javadoc on javadoc.io and GitHub Pages Signed-off-by: Arthit Suriyawongkul <[email protected]>
1 parent a659520 commit 60f9c2e

File tree

2 files changed

+22
-7
lines changed

2 files changed

+22
-7
lines changed

CONTRIBUTING.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,18 @@
11
Contributing
22
============
3+
34
Thank you for your interest in `spdx-java-jackson-store`. The project is open-source software, and bug reports, suggestions, and most especially patches are welcome.
45

56
Issues
67
------
8+
79
`spdx-java-jackson-store` has a [project page on GitHub](https://github.com/spdx/spdx-java-jdf-store) where you can [create an issue](https://github.com/spdx/spdx-java-jackson-store/issues) to report a bug, make a suggestion, or propose a substantial change or improvement that you might like to make. You may also wish to contact the SPDX working group technical team through its mailing list, [[email protected]](mailto:[email protected]).
810

911
If you would like to work on a fix for any issue, please assign the issue to yourself prior to creating a Pull Request.
1012

1113
Pull Requests
1214
-------
15+
1316
The source code for `spdx-java-jackson-store` is hosted on [github.com/spdx/spdx-java-jackson-store](https://github.com/spdx/spdx-java-jackson-store). Please review [open pull requests](https://github.com/spdx/spdx-java-jackson-store/pulls) and [active branches](https://github.com/spdx/spdx-java-jackson-store/branches) before committing time to a substantial revision. Work along similar lines may already be in progress.
1417

1518
To submit a pull request via GitHub, fork the repository, create a topic branch from `master` for your work, and send a pull request when ready. If you would prefer to send a patch or grant access to pull from your own Git repository, please contact the project's contributors by e-mail.
@@ -20,4 +23,5 @@ Once implemented, submit a pull request with `spec/X.X` branch as the parent bra
2023

2124
Licensing
2225
---------
23-
However you choose to contribute, please sign-off in each of your commits that you license your contributions under the terms of [the Developer Certificate of Origin](https://developercertificate.org/). Git has utilities for signing off on commits: `git commit -s` signs a current commit, and `git rebase --signoff <revision-range>` retroactively signs a range of past commits.
26+
27+
However you choose to contribute, please sign-off in each of your commits that you license your contributions under the terms of [the Developer Certificate of Origin](https://developercertificate.org/). Git has utilities for signing off on commits: `git commit -s` signs a current commit, and `git rebase --signoff <revision-range>` retroactively signs a range of past commits.

README.md

Lines changed: 17 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,21 @@
11
# spdx-java-jackson-store
2+
3+
[![javadoc](https://javadoc.io/badge2/org.spdx/spdx-jackson-store/javadoc.svg)](https://javadoc.io/doc/org.spdx/spdx-jackson-store)
4+
25
Storage for SPDX documents utilizing [Jackson Databind](https://github.com/FasterXML/jackson-databind).
36

47
This store supports serializing and deserializing files in JSON, YAML and XML formats.
58

69
This library utilizes the [SPDX Java Library Storage Interface](https://github.com/spdx/Spdx-Java-Library#storage-interface) extending the `ExtendedSpdxStore` which allows for utilizing any underlying store which implements the [SPDX Java Library Storage Interface](https://github.com/spdx/Spdx-Java-Library#storage-interface).
710

8-
# Code quality badges
11+
## Code quality badges
912

10-
| [![Bugs](https://sonarcloud.io/api/project_badges/measure?project=spdx-jackson-store&metric=bugs)](https://sonarcloud.io/dashboard?id=spdx-jackson-store) | [![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=spdx-jackson-store&metric=security_rating)](https://sonarcloud.io/dashboard?id=spdx-jackson-store) | [![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=spdx-jackson-store&metric=sqale_rating)](https://sonarcloud.io/dashboard?id=spdx-jackson-store) | [![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=spdx-jackson-store&metric=sqale_index)](https://sonarcloud.io/dashboard?id=spdx-jackson-store) |
13+
[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=spdx-jackson-store&metric=bugs)](https://sonarcloud.io/dashboard?id=spdx-jackson-store)
14+
[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=spdx-jackson-store&metric=security_rating)](https://sonarcloud.io/dashboard?id=spdx-jackson-store)
15+
[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=spdx-jackson-store&metric=sqale_rating)](https://sonarcloud.io/dashboard?id=spdx-jackson-store)
16+
[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=spdx-jackson-store&metric=sqale_index)](https://sonarcloud.io/dashboard?id=spdx-jackson-store)
1117

12-
# Using the Library
18+
## Using the Library
1319

1420
This library is intended to be used in conjunction with the [SPDX Java Library](https://github.com/spdx/Spdx-Java-Library).
1521

@@ -22,10 +28,15 @@ Create an instance of `MultiFormatStore(IModelStore baseStore, Format format)` p
2228
- `XML` - XML Format
2329
- `YAML` - YAML format
2430

25-
# Serializing and Deserializing
31+
## Serializing and Deserializing
2632

2733
This library supports the `ISerializableModelStore` interface for serializing and deserializing files based on the format specified.
2834

29-
# Development Status
35+
## API Documentation
36+
37+
- [Released API documentation](https://www.javadoc.io/doc/org.spdx/spdx-jackson-store) (as released on Maven Central)
38+
- [Development API documentation](https://spdx.github.io/spdx-java-jackson-store/) (updated with each GitHub change)
39+
40+
## Development Status
3041

31-
Mostly stable - although it has not been widely used.
42+
Mostly stable - although it has not been widely used.

0 commit comments

Comments
 (0)