diff --git a/README.md b/README.md index 63c5590..b4bd8cd 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,199 @@ -# jsthermalcomfort +# Overview -jsthermalcomfort is a JavaScript package that allows users to calculate thermal comfort indices, including Predicted Mean Vote (PMV), Standard Effective Temperature (SET), and Predicted Heat Strain (PHS). +| docs | [![docs](https://github.com/FedericoTartarini/jsthermalcomfort/actions/workflows/test_docs.yml/badge.svg)][docs_link] | +| :-----------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| **build** | [![build](https://github.com/FedericoTartarini/jsthermalcomfort/actions/workflows/build.yml/badge.svg)][build_link] | +| **tests** | [![test](https://github.com/FedericoTartarini/jsthermalcomfort/actions/workflows/test.yml/badge.svg)][test_link] | +| **page deployment** | [![page deployment](https://github.com/FedericoTartarini/jsthermalcomfort/actions/workflows/pages/pages-build-deployment/badge.svg)][deploy_link] | +| **snyk security** | [![synk](https://github.com/FedericoTartarini/jsthermalcomfort/actions/workflows/snyk.yml/badge.svg)][synk_link] | +| **license** | [![license](https://custom-icon-badges.demolab.com/github/license/denvercoder1/custom-icon-badges?logo=law)](https://github.com/FedericoTartarini/jsthermalcomfort/blob/main/LICENSE) | +| **npm version** | [![npm](https://img.shields.io/npm/v/jsthermalcomfort?style=plastic&logo=npm&logoColor=rgb)][npm_link] | -## Installation +Package to calculate several thermal comfort indices (e.g. PMV, PPD, SET, adaptive) and convert physical variables. -Using npm: +Please cite us if you use this package: [Tartarini, F., Schiavon, S., 2020. pythermalcomfort: A Python package for thermal comfort research. SoftwareX 12, 100578. https://doi.org/10.1016/j.softx.2020.100578](https://www.sciencedirect.com/science/article/pii/S2352711020302910) -``` +- Free software: MIT license +- Authors: [Omar Jesus Acuache Briceno](https://www.linkedin.com/in/omar-acuache), [Ruoshui Chen](https://github.com/ChristinChen233), [Jingyu Lu](https://github.com/Lu-Whale), [Yuchen Mu](https://github.com/YuchenMu), [Jordan Ocokoljic](https://github.com/JordanOcokoljic), [Santiago Zaldivar del Alba​](https://github.com/szaldivar) + +[docs_link]: https://github.com/FedericoTartarini/jsthermalcomfort/actions/workflows/test_docs.yml +[build_link]: https://github.com/FedericoTartarini/jsthermalcomfort/actions/workflows/build.yml +[test_link]: https://github.com/FedericoTartarini/jsthermalcomfort/actions/workflows/test.yml +[deploy_link]: https://github.com/FedericoTartarini/jsthermalcomfort/actions/workflows/pages/pages-build-deployment +[synk_link]: https://github.com/FedericoTartarini/jsthermalcomfort/actions/workflows/snyk.yml +[npm_link]: https://www.npmjs.com/package/jsthermalcomfort + +# Installation + +```bash npm install jsthermalcomfort ``` + +if you want to use jsthermalcomfort package without installing it on your local machine, you can import with: + +[`https://cdn.jsdelivr.net/gh/FedericoTartarini/jsthermalcomfort/lib/esm/`](https://cdn.jsdelivr.net/gh/FedericoTartarini/jsthermalcomfort/lib/esm/) + +Example: + +```javascript +import { + models, + utilities, + pschymetrics, +} from "https://cdn.jsdelivr.net/gh/FedericoTartarini/jsthermalcomfort/lib/esm/index.js"; +``` + +You can also import it in the website directly, and caution that you need to mark the script as module: + +```html + +``` + +# Examples and Tutorials + +## [Examples](https://github.com/FedericoTartarini/jsthermalcomfort/tree/main/docs/examples) files on how to use some of the functions + +Here is a list of examples running in the browser: + +- [PHS](/jsthermalcomfort/examples/phs.html) + +# Contributing + +Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given. + +## Bug reports + +When [reporting a bug](https://github.com/FedericoTartarini/jsthermalcomfort/issues) please include: + +- Your operating system name and version. +- Any details about your local setup that might be helpful in troubleshooting. +- Detailed steps to reproduce the bug. + +## Documentation improvements + +jsthermalcomfort could always use more documentation, whether as part of the official jsthermalcomfort docs, in JSDocs, or even on the web in blog posts, articles, and such. + +## Feature requests and feedback + +The best way to send feedback is to file an issue at [https://github.com/FedericoTartarini/jsthermalcomfort/issues](https://github.com/FedericoTartarini/jsthermalcomfort/issues) + +If you are proposing a feature: + +- Explain in detail how it would work. +- Keep the scope as narrow as possible, to make it easier to implement. +- Remember that this is a volunteer-driven project, and that code contributions are welcome :) + +## Development + +To set up jsthermalcomfort for local development: + +1. Fork jsthermalcomfort (look for the “Fork” button). +2. Clone your fork locally. Fetch and pull all the updates from the master branch before you do anything: + + ```bash + git clone git@github.com:FedericoTartarini/jsthermalcomfort.git + ``` + +3. Create a branch for local development. The naming rule for new branch are, as follows: + + - If this update is for a new feature Feature/feature_name_here + - If this update is for bug fix Fix/bug_name_here + - If this update is for documentation Documentation/doc_name_here + + You can create a branch locally using the following command. Make sure you only push updates to this new branch only: + + ```bash + git checkout -b name-of-your-bugfix-or-feature + ``` + + Now you can make your changes locally. + +4. When you’re done making changes run all tests using Jest: + + ```bash + npm run test + ``` + + - Run prettier to format your code: + + ```bash + npm run format + ``` + + - Commit your changes: + + ```bash + git add . + git commit -m "Your detailed description of your changes." + ``` + + - Update the docs: + + ```bash + npm run docs + ``` + + - Commit your documentation changes: + + ```bash + git add . + git commit -m "Your detailed description of your changes." + ``` + + - Push your branch to GitHub: + + ```bash + git push origin name-of-your-bugfix-or-feature + ``` + +5. Submit a pull request after you have done all your modifications and tested your work. The pull request should include a detailed description of your work: + - What this pull request is about + - Have you tested your work + - Will this work affect other component in the product + +### Pull Request Guidelines + +If you need some code review or feedback while you’re developing the code just make the pull request. + +For merging, you should: + +- Include passing tests (run `npm run test`). +- Update documentation when there’s new API, functionality etc. + +### Documentation + +We are using [JSDoc](https://jsdoc.app/) and [documentation.js](https://github.com/documentationjs/documentation) to automatically build the documentation. + +### To add a function + +1. Add a file under `src/models/` with the name of the function/model and document it. +2. Add any related functions that are used by your function either in `src/utilities/utilities.js` or `src/psychrometrics/`. See existing code as example. + - In order to add a new function/API to the library you should mark that function as `@public`, add it to its corresponding category, for example for models you should do `@memberof models`, and lastly you should give it a proper name for the documentation with `@docname`, for example: `@docname Clothing prediction`. It is important to note that you should also add the `@public` tag to any types the function exposes/uses. +3. Test your function by writing a test in `tests/models/.test.js`. + +### Tips + +To run a subset of tests you can do the following: + +```bash +npm run test -- '' -t '' +``` + +If you are using VSCode you can use the [Jest Runner extension](https://marketplace.visualstudio.com/items?itemName=firsttris.vscode-jest-runner) to easily run subset of tests. + +### Releases + +To create a new release do the following: + +1. Update the `package.json` version to the new version (we use the semantic release system for versioning) +2. Run `npm run build` to update the `lib` directory (output with types of the library that gets published to NPM) and commit the updates +3. In GitHub go to Releases -> click `Draft a new release` +4. Click `Choose a tag` and type the new version, for example `v0.1,1` +5. Write the title and description and click `Publish release` +6. This will trigger a GitHub action that will publish the new version to NPM diff --git a/create_readme.sh b/create_readme.sh new file mode 100755 index 0000000..b8193bb --- /dev/null +++ b/create_readme.sh @@ -0,0 +1,10 @@ +#!/usr/bin/env bash +printf "# Overview\n\n" > README.md +cat ./docs_theme/overview.md >> README.md +printf "\n\n# Installation\n\n" >> README.md +cat ./docs_theme/installation.md >> README.md +printf "\n\n# Examples and Tutorials\n\n" >> README.md +cat ./docs_theme/examples.md >> README.md +printf "\n\n# Contributing\n\n" >> README.md +cat ./docs_theme/contributing.md >> README.md +npx prettier README.md --write diff --git a/docs/index.html b/docs/index.html index bcbe3af..781a6c1 100644 --- a/docs/index.html +++ b/docs/index.html @@ -498,6 +498,18 @@

jsthermalcomfort

+
  • + Contributing + + + +
  • + + + +
  • @@ -654,7 +666,7 @@

    -

    Examples files on how to use some of the functions

    +

    Examples files on how to use some of the functions

    Here is a list of examples running in the browser:

    • PHS
    • @@ -723,7 +735,7 @@

      - + src/models/index.js @@ -774,7 +786,7 @@

      - + src/models/heat_index.js @@ -926,7 +938,7 @@

      - + src/models/phs.js @@ -1077,7 +1089,7 @@

      - + src/models/phs.js @@ -1259,7 +1271,7 @@

      - + src/models/phs.js @@ -1429,7 +1441,7 @@

      - + src/models/humidex.js @@ -1549,7 +1561,7 @@

      - + src/models/humidex.js @@ -1664,7 +1676,7 @@

      - + src/models/net.js @@ -1825,7 +1837,7 @@

      - + src/models/wbgt.js @@ -2007,7 +2019,7 @@

      - + src/models/discomfort_index.js @@ -2092,7 +2104,7 @@

      - + src/models/discomfort_index.js @@ -2213,7 +2225,7 @@

      - + src/models/discomfort_index.js @@ -2298,7 +2310,7 @@

      - + src/models/discomfort_index.js @@ -2413,7 +2425,7 @@

      - + src/models/two_nodes.js @@ -2607,7 +2619,7 @@

      - + src/models/two_nodes.js @@ -2705,7 +2717,7 @@

      - + src/models/two_nodes.js @@ -2958,7 +2970,7 @@

      - + src/models/two_nodes.js @@ -3147,7 +3159,7 @@

      - + src/models/two_nodes.js @@ -3400,7 +3412,7 @@

      - + src/models/set_tmp.js @@ -3587,7 +3599,7 @@

      - + src/models/set_tmp.js @@ -3708,7 +3720,7 @@

      - + src/models/set_tmp.js @@ -3924,7 +3936,7 @@

      - + src/models/wc.js @@ -4061,7 +4073,7 @@

      - + src/models/adaptive_en.js @@ -4194,7 +4206,7 @@

      - + src/models/adaptive_en.js @@ -4385,7 +4397,7 @@

      - + src/models/adaptive_en.js @@ -4518,7 +4530,7 @@

      - + src/models/adaptive_en.js @@ -4700,7 +4712,7 @@

      - + src/models/at.js @@ -4862,7 +4874,7 @@

      - + src/models/pmv_ppd.js @@ -5042,7 +5054,7 @@

      - + src/models/pmv_ppd.js @@ -5144,7 +5156,7 @@

      - + src/models/pmv_ppd.js @@ -5277,7 +5289,7 @@

      - + src/models/pmv_ppd.js @@ -5456,7 +5468,7 @@

      - + src/models/pmv_ppd.js @@ -5589,7 +5601,7 @@

      - + src/models/adaptive_ashrae.js @@ -5729,7 +5741,7 @@

      - + src/models/adaptive_ashrae.js @@ -5909,7 +5921,7 @@

      - + src/models/adaptive_ashrae.js @@ -6049,7 +6061,7 @@

      - + src/models/adaptive_ashrae.js @@ -6229,7 +6241,7 @@

      - + src/models/solar_gain.js @@ -6399,7 +6411,7 @@

      - + src/models/solar_gain.js @@ -6514,7 +6526,7 @@

      - + src/models/cooling_effect.js @@ -6698,7 +6710,7 @@

      - + src/models/athb.js @@ -6863,7 +6875,7 @@

      - + src/models/athb.js @@ -7029,7 +7041,7 @@

      - + src/models/pmv.js @@ -7205,7 +7217,7 @@

      - + src/models/pmv.js @@ -7357,7 +7369,7 @@

      - + src/models/pmv.js @@ -7576,7 +7588,7 @@

      - + src/models/a_pmv.js @@ -7739,7 +7751,7 @@

      - + src/models/a_pmv.js @@ -7874,7 +7886,7 @@

      - + src/models/a_pmv.js @@ -8077,7 +8089,7 @@

      - + src/models/ankle_draft.js @@ -8232,7 +8244,7 @@

      - + src/models/ankle_draft.js @@ -8345,7 +8357,7 @@

      - + src/models/e_pmv.js @@ -8509,7 +8521,7 @@

      - + src/models/e_pmv.js @@ -8646,7 +8658,7 @@

      - + src/models/e_pmv.js @@ -8852,7 +8864,7 @@

      - + src/models/vertical_tmp_grad_ppd.js @@ -8994,7 +9006,7 @@

      - + src/models/vertical_tmp_grad_ppd.js @@ -9107,7 +9119,7 @@

      - + src/models/use_fans_heatwave.js @@ -9293,7 +9305,7 @@

      - + src/models/use_fans_heatwave.js @@ -9386,7 +9398,7 @@

      - + src/models/use_fans_heatwave.js @@ -9622,7 +9634,7 @@

      - + src/models/clo_tout.js @@ -9732,7 +9744,7 @@

      - + src/models/clo_tout.js @@ -9842,7 +9854,7 @@

      - + src/models/utci.js @@ -10013,7 +10025,7 @@

      - + src/models/utci.js @@ -10186,7 +10198,7 @@

      - + src/models/pet_steady.js @@ -10420,7 +10432,7 @@

      - + src/psychrometrics/index.js @@ -10471,7 +10483,7 @@

      - + src/psychrometrics/p_sat.js @@ -10554,7 +10566,7 @@

      - + src/psychrometrics/p_sat_torr.js @@ -10646,7 +10658,7 @@

      - + src/psychrometrics/p_sat_torr.js @@ -10738,7 +10750,7 @@

      - + src/psychrometrics/t_o.js @@ -10858,7 +10870,7 @@

      - + src/psychrometrics/t_o.js @@ -10978,7 +10990,7 @@

      - + src/psychrometrics/enthalpy.js @@ -11070,7 +11082,7 @@

      - + src/psychrometrics/t_wb.js @@ -11162,7 +11174,7 @@

      - + src/psychrometrics/t_mrt.js @@ -11310,7 +11322,7 @@

      - + src/psychrometrics/t_mrt.js @@ -11450,7 +11462,7 @@

      - + src/psychrometrics/psy_ta_rh.js @@ -11537,7 +11549,7 @@

      - + src/psychrometrics/psy_ta_rh.js @@ -11686,7 +11698,7 @@

      - + src/utilities/index.js @@ -11737,7 +11749,7 @@

      - + src/utilities/utilities.js @@ -11839,7 +11851,7 @@

      - + src/utilities/utilities.js @@ -11943,7 +11955,7 @@

      - + src/utilities/utilities.js @@ -12047,7 +12059,7 @@

      - + src/utilities/utilities.js @@ -12163,7 +12175,7 @@

      - + src/utilities/utilities.js @@ -12279,7 +12291,7 @@

      - + src/utilities/utilities.js @@ -12381,7 +12393,7 @@

      - + src/utilities/utilities.js @@ -12483,7 +12495,7 @@

      - + src/utilities/utilities.js @@ -12602,7 +12614,7 @@

      - + src/utilities/utilities.js @@ -12717,7 +12729,7 @@

      - + src/utilities/index.js @@ -12768,7 +12780,7 @@

      - + src/utilities/utilities.js @@ -13064,7 +13076,7 @@

      - + src/utilities/utilities.js @@ -13164,7 +13176,7 @@

      - + src/utilities/utilities.js @@ -13649,6 +13661,126 @@

      +
      + +

      + Contributing +

      + + +

      Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.

      +

      Bug reports

      +

      When reporting a bug please include:

      +
        +
      • Your operating system name and version.
      • +
      • Any details about your local setup that might be helpful in troubleshooting.
      • +
      • Detailed steps to reproduce the bug.
      • +
      +

      Documentation improvements

      +

      jsthermalcomfort could always use more documentation, whether as part of the official jsthermalcomfort docs, in JSDocs, or even on the web in blog posts, articles, and such.

      +

      Feature requests and feedback

      +

      The best way to send feedback is to file an issue at https://github.com/FedericoTartarini/jsthermalcomfort/issues

      +

      If you are proposing a feature:

      +
        +
      • Explain in detail how it would work.
      • +
      • Keep the scope as narrow as possible, to make it easier to implement.
      • +
      • Remember that this is a volunteer-driven project, and that code contributions are welcome :)
      • +
      +

      Development

      +

      To set up jsthermalcomfort for local development:

      +
        +
      1. +

        Fork jsthermalcomfort (look for the “Fork” button).

        +
      2. +
      3. +

        Clone your fork locally. Fetch and pull all the updates from the master branch before you do anything:

        +
        git clone git@github.com:FedericoTartarini/jsthermalcomfort.git
        +
      4. +
      5. +

        Create a branch for local development. The naming rule for new branch are, as follows:

        +
          +
        • If this update is for a new feature Feature/feature_name_here
        • +
        • If this update is for bug fix Fix/bug_name_here
        • +
        • If this update is for documentation Documentation/doc_name_here
        • +
        +

        You can create a branch locally using the following command. Make sure you only push updates to this new branch only:

        +
        git checkout -b name-of-your-bugfix-or-feature
        +

        Now you can make your changes locally.

        +
      6. +
      7. +

        When you’re done making changes run all tests using Jest:

        +
        npm run test
        +
          +
        • Run prettier to format your code:
        • +
        +
        npm run format
        +
          +
        • Commit your changes:
        • +
        +
        git add .
        +git commit -m "Your detailed description of your changes."
        +
          +
        • Update the docs:
        • +
        +
        npm run docs
        +
          +
        • Commit your documentation changes:
        • +
        +
        git add .
        +git commit -m "Your detailed description of your changes."
        +
          +
        • Push your branch to GitHub:
        • +
        +
        git push origin name-of-your-bugfix-or-feature
        +
      8. +
      9. +

        Submit a pull request after you have done all your modifications and tested your work. The pull request should include a detailed description of your work:

        +
          +
        • What this pull request is about
        • +
        • Have you tested your work
        • +
        • Will this work affect other component in the product
        • +
        +
      10. +
      +

      Pull Request Guidelines

      +

      If you need some code review or feedback while you’re developing the code just make the pull request.

      +

      For merging, you should:

      +
        +
      • Include passing tests (run npm run test).
      • +
      • Update documentation when there’s new API, functionality etc.
      • +
      +

      Documentation

      +

      We are using JSDoc and documentation.js to automatically build the documentation.

      +

      To add a function

      +
        +
      1. Add a file under src/models/ with the name of the function/model and document it.
      2. +
      3. Add any related functions that are used by your function either in src/utilities/utilities.js or src/psychrometrics/. See existing code as example. +
          +
        • In order to add a new function/API to the library you should mark that function as @public, add it to its corresponding category, for example for models you should do @memberof models, and lastly you should give it a proper name for the documentation with @docname, for example: @docname Clothing prediction. It is important to note that you should also add the @public tag to any types the function exposes/uses.
        • +
        +
      4. +
      5. Test your function by writing a test in tests/models/<name_of_model>.test.js.
      6. +
      +

      Tips

      +

      To run a subset of tests you can do the following:

      +
      npm run test -- '<path_to_test_file>' -t '<test_pattern/name>'
      +

      If you are using VSCode you can use the Jest Runner extension to easily run subset of tests.

      +

      Releases

      +

      To create a new release do the following:

      +
        +
      1. Update the package.json version to the new version (we use the semantic release system for versioning)
      2. +
      3. Run npm run build to update the lib directory (output with types of the library that gets published to NPM) and commit the updates
      4. +
      5. In GitHub go to Releases -> click Draft a new release
      6. +
      7. Click Choose a tag and type the new version, for example v0.1,1
      8. +
      9. Write the title and description and click Publish release
      10. +
      11. This will trigger a GitHub action that will publish the new version to NPM
      12. +
      + + +
      + + +

      diff --git a/docs_theme/contributing.md b/docs_theme/contributing.md new file mode 100644 index 0000000..fb188b8 --- /dev/null +++ b/docs_theme/contributing.md @@ -0,0 +1,103 @@ + +Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given. + +## Bug reports +When [reporting a bug](https://github.com/FedericoTartarini/jsthermalcomfort/issues) please include: +- Your operating system name and version. +- Any details about your local setup that might be helpful in troubleshooting. +- Detailed steps to reproduce the bug. + +## Documentation improvements +jsthermalcomfort could always use more documentation, whether as part of the official jsthermalcomfort docs, in JSDocs, or even on the web in blog posts, articles, and such. + +## Feature requests and feedback +The best way to send feedback is to file an issue at [https://github.com/FedericoTartarini/jsthermalcomfort/issues](https://github.com/FedericoTartarini/jsthermalcomfort/issues) + +If you are proposing a feature: +- Explain in detail how it would work. +- Keep the scope as narrow as possible, to make it easier to implement. +- Remember that this is a volunteer-driven project, and that code contributions are welcome :) + +## Development +To set up jsthermalcomfort for local development: +1. Fork jsthermalcomfort (look for the “Fork” button). +2. Clone your fork locally. Fetch and pull all the updates from the master branch before you do anything: + + ```bash + git clone git@github.com:FedericoTartarini/jsthermalcomfort.git + ``` + +3. Create a branch for local development. The naming rule for new branch are, as follows: + - If this update is for a new feature Feature/feature_name_here + - If this update is for bug fix Fix/bug_name_here + - If this update is for documentation Documentation/doc_name_here + + You can create a branch locally using the following command. Make sure you only push updates to this new branch only: + ```bash + git checkout -b name-of-your-bugfix-or-feature + ``` + Now you can make your changes locally. + +4. When you’re done making changes run all tests using Jest: + ```bash + npm run test + ``` + - Run prettier to format your code: + ```bash + npm run format + ``` + - Commit your changes: + ```bash + git add . + git commit -m "Your detailed description of your changes." + ``` + - Update the docs: + ```bash + npm run docs + ``` + - Commit your documentation changes: + ```bash + git add . + git commit -m "Your detailed description of your changes." + ``` + - Push your branch to GitHub: + ```bash + git push origin name-of-your-bugfix-or-feature + ``` + +5. Submit a pull request after you have done all your modifications and tested your work. The pull request should include a detailed description of your work: + - What this pull request is about + - Have you tested your work + - Will this work affect other component in the product + +### Pull Request Guidelines +If you need some code review or feedback while you’re developing the code just make the pull request. + +For merging, you should: +- Include passing tests (run `npm run test`). +- Update documentation when there’s new API, functionality etc. + +### Documentation +We are using [JSDoc](https://jsdoc.app/) and [documentation.js](https://github.com/documentationjs/documentation) to automatically build the documentation. + +### To add a function +1. Add a file under `src/models/` with the name of the function/model and document it. +2. Add any related functions that are used by your function either in `src/utilities/utilities.js` or `src/psychrometrics/`. See existing code as example. + - In order to add a new function/API to the library you should mark that function as `@public`, add it to its corresponding category, for example for models you should do `@memberof models`, and lastly you should give it a proper name for the documentation with `@docname`, for example: `@docname Clothing prediction`. It is important to note that you should also add the `@public` tag to any types the function exposes/uses. +3. Test your function by writing a test in `tests/models/.test.js`. + +### Tips +To run a subset of tests you can do the following: +```bash +npm run test -- '' -t '' +``` +If you are using VSCode you can use the [Jest Runner extension](https://marketplace.visualstudio.com/items?itemName=firsttris.vscode-jest-runner) to easily run subset of tests. + +### Releases +To create a new release do the following: +1. Update the `package.json` version to the new version (we use the semantic release system for versioning) +2. Run `npm run build` to update the `lib` directory (output with types of the library that gets published to NPM) and commit the updates +3. In GitHub go to Releases -> click `Draft a new release` +4. Click `Choose a tag` and type the new version, for example `v0.1,1` +5. Write the title and description and click `Publish release` +6. This will trigger a GitHub action that will publish the new version to NPM diff --git a/docs_theme/examples.md b/docs_theme/examples.md index 726fc24..c2ec602 100644 --- a/docs_theme/examples.md +++ b/docs_theme/examples.md @@ -1,4 +1,4 @@ -# [Examples](https://github.com/FedericoTartarini/jsthermalcomfort/tree/main/docs/examples) files on how to use some of the functions +## [Examples](https://github.com/FedericoTartarini/jsthermalcomfort/tree/main/docs/examples) files on how to use some of the functions Here is a list of examples running in the browser: - [PHS](/jsthermalcomfort/examples/phs.html) \ No newline at end of file diff --git a/documentation.yml b/documentation.yml index 926e77f..61f30c8 100644 --- a/documentation.yml +++ b/documentation.yml @@ -11,5 +11,7 @@ toc: - psychrometrics - utilities - reference_values + - name: Contributing + file: docs_theme/contributing.md - name: References file: docs_theme/references.md diff --git a/package.json b/package.json index 528eeea..1e87029 100644 --- a/package.json +++ b/package.json @@ -25,7 +25,7 @@ "build:cjs": "tsc -p ./configs/tsconfig.cjs.json", "test": "node --experimental-vm-modules ./node_modules/.bin/jest", "semantic-release": "semantic-release", - "docs": "npx documentation build ./src/index.js -f html --github --config documentation.yml -a public --theme docs_theme/index.js -o docs", + "docs": "npx documentation build ./src/index.js -f html --github --config documentation.yml -a public --theme docs_theme/index.js -o docs && ./create_readme.sh", "format": "npx prettier . --write", "check:format": "npx prettier . --check" },