Skip to content

Commit

Permalink
v2: add change log and docs (#41)
Browse files Browse the repository at this point in the history
* add change log and docs

* add version to english docs
  • Loading branch information
raulfdm authored Apr 25, 2023
1 parent d5c3a4f commit f3eeb2d
Show file tree
Hide file tree
Showing 4 changed files with 57 additions and 5 deletions.
24 changes: 24 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,30 @@ Security in case of vulnerabilities.
-->

## [2.0.0]

This is the major change after 5 years of this project creation.

I've decided to revamp completely the project using modern tech and implementing a few features some people asked a couple years ago.

### What has changed?

The main change here is now the project is complete type-safe thanks to [Prisma](https://prisma.io).

Also, instead Rest API, I've decide to switch completely to GraphQL. This will makes the documentation and the ability to fetch data easier.

### all changes

- refactor everything to TypeScript;
- re-done the data processing to fix data mistakes such as keeping strings with numbers;
- remove APIDoc in favor of GraphQL api docs;
- update docs;
- switch from `npm` to `pnpm`;
- use relational database (`SQLite`) instead local `json` files for storing data;
- implement filter ability. Now for in a few endpoints you can pass `skip` and `take` ([see more here](https://www.prisma.io/docs/concepts/components/prisma-client/pagination#offset-pagination));
- migrate to Node18;
- use full ESM instead CJS;

## [1.0.1]

- tag docker image with `v1`
Expand Down
8 changes: 3 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,13 @@

> Brazilian Table of Food Composition
<p>
![GraphQL Client](./documentation/images/graphql-client.png)

<p align="center">
<a href="https://github.com/raulfdm/taco-api/actions/workflows/app.yml">
<img src="https://github.com/raulfdm/taco-api/actions/workflows/app.yml/badge.svg"
alt="build status">
</a>
<a href="https://travis-ci.org/raulfdm/taco-api">
<img src="https://travis-ci.org/raulfdm/taco-api.svg?branch=master"
alt="build status">
</a>
</p>

## Docs
Expand Down
30 changes: 30 additions & 0 deletions documentation/.vuepress/config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,21 @@ export default defineUserConfig({
repo: 'raulfdm/taco-api',
locales: {
'/': {
navbar: [
{
text: 'Versão',
children: [
{
text: 'Changelog',
link: 'https://github.com/raulfdm/taco-api/blob/main/CHANGELOG.md',
},
{
text: 'v1.0.0',
link: 'https://6447d8ec2c2ccb00085151ca--taco-api.netlify.app/',
},
],
},
],
selectLanguageName: 'Português',
toggleColorMode: 'Alternar modo escuro',
openInNewWindow: 'Abrir em nova aba',
Expand All @@ -18,6 +33,21 @@ export default defineUserConfig({
selectLanguageText: 'Idiomas',
},
'/en/': {
navbar: [
{
text: 'Version',
children: [
{
text: 'Changelog',
link: 'https://github.com/raulfdm/taco-api/blob/main/CHANGELOG.md',
},
{
text: 'v1.0.0',
link: 'https://6447d8ec2c2ccb00085151ca--taco-api.netlify.app/',
},
],
},
],
selectLanguageName: 'English',
},
},
Expand Down
Binary file added documentation/images/graphql-client.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit f3eeb2d

Please sign in to comment.