Skip to content

Commit

Permalink
docs: update docs to add synchronizeReadingList
Browse files Browse the repository at this point in the history
input option values in readme and example md
  • Loading branch information
Anmol-Baranwal committed Mar 4, 2024
1 parent d8c30ab commit e1c55ce
Show file tree
Hide file tree
Showing 2 changed files with 6 additions and 5 deletions.
5 changes: 3 additions & 2 deletions Examples.md
Original file line number Diff line number Diff line change
Expand Up @@ -132,11 +132,11 @@ jobs:
![create reading list](https://github.com/Anmol-Baranwal/DevtoGitHub/assets/74038190/d13f89a7-7999-4dab-9efb-12094918d078)


## Reading List with read time
## Reading List with read time & synchronization with DEV.

> Explanation

This will stop saving your articles since `saveArticles` is set to `false` (default is `true`). It will create your reading list with the articles in a structured way. You can change which directory you want using `outputDirReading`. For instance, the below workflow will save your articles in the `read` directory by adding your info in a `README`. It will add a reading time with the articles when `readTime` is set to `true` (default is `false`).
This will stop saving your articles since `saveArticles` is set to `false` (default is `true`). It will create your reading list with the articles in a structured way. You can change which directory you want using `outputDirReading`. For instance, the below workflow will save your articles in the `read` directory by adding your info in a `README`. It will add a reading time with the articles when `readTime` is set to `true` (default is `false`). Setting `synchronizeReadingList` to `true` will synchronize your reading list from DEV, removing any article from your reading list on DEV will also remove it from the readme here.

> Workflow code

Expand Down Expand Up @@ -166,6 +166,7 @@ jobs:
readingList: true
outputDirReading: "read" # this will save reading list in read/Readme.md
readTime: true
synchronizeReadingList: true
```

> Output
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,7 @@ Your sentences are clear, but here are some minor grammar adjustments for clarit
- I've included [custom logic](https://github.com/Anmol-Baranwal/DevtoGitHub?tab=readme-ov-file#the-concept-of-excludetags-and-mustincludetags) based on tags to provide you with more flexibility in managing your reading list.
- All articles and the reading list will be fetched regardless of the total number.
- If you update an article on DEV, it will be automatically updated here the next time the workflow runs.
- You can synchronize your reading list from DEV. For instance, if you remove any article from the reading list on DEV, then it will also be removed in the reading list in the readme.

---

Expand Down Expand Up @@ -75,6 +76,7 @@ Various inputs are defined to let you configure the action:
| `mustIncludeTags` | To create a reading list to include this tag prioritizing over excludeTags. Use commas to separate if there are multiple tags. | `''` | `No` |
| `branch` | The git branch to use for these process. | `'main'` | `No` |
| `conventionalCommits` | To use conventional commit message standards. | `'true'` | `No` |
| `synchronizeReadingList` | To synchronize the reading list from DEV. Removing an article from the reading list on DEV will also remove it from the repository. | `'false'` | `No` |

<br>

Expand All @@ -95,8 +97,6 @@ Suppose we have an article with tags: `['react', 'javascript', 'frontend', 'tuto
- If `excludeTags` is 'backend' and `mustIncludeTags` is 'typescript'. The article is included because it does not have the `backend` tag.
- These cases will work for multiple tags, and `mustIncludeTags` will only work if `excludeTags` is provided.

> Please note that even if you remove a article from your reading list on DEV, it's isn't deleted from this repository. I'm going to solve this in the future release.

---

## 🤝 How to Contribute?
Expand Down Expand Up @@ -130,7 +130,7 @@ The scripts and documentation in this project are released under the <a href="./
<img src="https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white" /> <img src="https://img.shields.io/badge/GitHub_Actions-2088FF?style=for-the-badge&logo=github-actions&logoColor=white" />
<img src="https://img.shields.io/badge/Postman-FF6C37?style=for-the-badge&logo=Postman&logoColor=white" />

- I've used Forem v1 APIs. You can refer to the [docs](https://developers.forem.com/api/v1).
- I've used Forem v1 APIs for building DevtoGithub. You can refer to the [docs](https://developers.forem.com/api/v1).

---

Expand Down

0 comments on commit e1c55ce

Please sign in to comment.