diff --git a/README.md b/README.md
index 1a7b056..d891caf 100644
--- a/README.md
+++ b/README.md
@@ -4,18 +4,15 @@ The template is a standardized, but flexible
Inspired by [literate programming](http://literateprogramming.com) and [Cookiecutter Data Science](https://drivendata.github.io/cookiecutter-data-science/), maintained by the [World Bank Development Data Group](https://www.worldbank.org/en/about/unit/unit-dec#2) and built as [GitHub template repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template), the template contains:
-- **README**, **CODE_OF_CONDUCT**, **CONTRIBUTING**
- > README files are important and often neglected. The files should inform anyone about about the first steps to use, learn and contribute to your project.
+- **README**, **CODE_OF_CONDUCT**, **CONTRIBUTING** templates
+ > README files are important and often neglected. The files should inform anyone about the first steps to use, learn and contribute to your project.
- **LICENSE**
- > The LICENSE is a document that determines what others can and cannot do with contents of the repository. If no license is present, no one has permission to use and/or modify your code.
-
-- [Issues and Pull Requests GitHub templates](https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository)
- > GitHub allows to customize how issues and pull requests are presented to the public. Custom templates encourage collaboration and maintainability.
+ > The LICENSE is a document that determines what others can and cannot do with contents of the repository. If no license is present, no one has permission to use and/or modify your code. The template is licensed under the [**World Bank Master Community License Agreement**](LICENSE). And so will projects generated from it.
- **docs/**
- > Documentation is often never priotized until last minute. The template aims to revert the malpractice by setting up the documentation as an integral part of the code repository. With the power of [Jupyter Book](https://jupyterbook.org), data practioners have a way to share [Jupyter notebooks](https://jupyter.org) on [GitHub Pages](https://pages.github.com) in a standardized and effortless way.
+ > Documentation is often never priotized until last minute. The template aims to revert the malpractice by setting up the documentation as an integral part, inspired by [literate programming](http://literateprogramming.com). With the power of [Jupyter Book](https://jupyterbook.org), data practioners have a way to share [Jupyter notebooks](https://jupyter.org) on [GitHub Pages](https://pages.github.com) in a standardized and effortless way.
- **docs/bibliography.bib**
> A `bibliography` using the [BibTeX](https://www.bibtex.org/Format/) format.
@@ -29,12 +26,17 @@ Inspired by [literate programming](http://literateprogramming.com) and [Cookiecu
- **notebooks/**
> Placeholder folder for [Jupyter notebooks](https://jupyter.org). Markdown files and Jupyter notebooks can be added to `docs/_toc.yml` (Table of Contents) to compose the *documentation*.
+- [Issues and Pull Requests GitHub templates](https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository)
+ > GitHub allows to customize how issues and pull requests are presented to the public. Custom templates encourage collaboration and maintainability.
+
```{important}
-Admittedly, even the best of the templates would never be perfect; the template aims to encourage teams to start thinking and assimilate **best practices**, **collaborative coding**, **documentation**, **reproducibility** as an integral part of the project. *In a standardized way*.
+With flexibility comes responsibility. Even the best of the templates would never be perfect for universe of cases out there.
-In this spirit, in case you have feedback, please [open an issue](https://github.com/worldbank/template/issues) or [submit a pull request](https://github.com/worldbank/template/pulls) to share your ideas and suggestions.
+In this spirit, if the template is not for you or in case you have feedback, your contributed would be appreciated. Please consider [opening an issue](https://github.com/worldbank/template/issues) or [submitting a pull request](https://github.com/worldbank/template/pulls) to share your ideas and suggestions.
```
+All in all, the template aims to encourage teams to start thinking and assimilate **best practices**, **collaborative coding**, **documentation**, **enginerring** and **reproducibility** as an integral part of the project. *In a standardized way*.
+
## Usage
### Getting Started
diff --git a/notebooks/nasa-apod.ipynb b/notebooks/nasa-apod.ipynb
index da53534..c0ad4a7 100644
--- a/notebooks/nasa-apod.ipynb
+++ b/notebooks/nasa-apod.ipynb
@@ -120,7 +120,7 @@
"id": "660db869",
"metadata": {},
"source": [
- "The template includes `.env.example` as an example; to use, simply rename it to `.env` and add your settings and secrets to it. Please note that `.env` **must** never be commited/versioned (for example, to GitHub) and **should** ignored on `.gitignore`. "
+ "The template includes `.env.example` as an example; to use, simply rename it to `.env` and add your settings and secrets to it. Please note that `.env` **must** never be commited/versioned (for example, to GitHub) and **should** be ignored on `.gitignore`. "
]
},
{
@@ -270,7 +270,7 @@
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
- "version": "3.10.6"
+ "version": "3.10.12"
},
"vscode": {
"interpreter": {
diff --git a/notebooks/world-bank-api.ipynb b/notebooks/world-bank-api.ipynb
index 4b103ac..d510e51 100644
--- a/notebooks/world-bank-api.ipynb
+++ b/notebooks/world-bank-api.ipynb
@@ -37,12 +37,19 @@
]
},
{
+ "attachments": {},
"cell_type": "markdown",
"id": "fb8d2738-535e-4957-b82a-987891955a7f",
"metadata": {},
"source": [
"## Retrieve Data\n",
"\n",
+ "https://data.worldbank.org/indicator\n",
+ "\n",
+ "\n",
+ "https://databank.worldbank.org/reports.aspx?source=World-Development-Indicators\n",
+ "\n",
+ "\n",
"In this example, we retrieve **Population, total** (`SP.POP.TOTL`) from the [World Bank Indicators](https://data.worldbank.org/indicator) for [BRICS](https://infobrics.org)."
]
},
@@ -597,7 +604,7 @@
" }\n",
"}(window));"
],
- "application/vnd.bokehjs_load.v0+json": "(function(root) {\n function now() {\n return new Date();\n }\n\n const force = true;\n\n if (typeof root._bokeh_onload_callbacks === \"undefined\" || force === true) {\n root._bokeh_onload_callbacks = [];\n root._bokeh_is_loading = undefined;\n }\n\n\n if (typeof (root._bokeh_timeout) === \"undefined\" || force === true) {\n root._bokeh_timeout = Date.now() + 5000;\n root._bokeh_failed_load = false;\n }\n\n const NB_LOAD_WARNING = {'data': {'text/html':\n \"\\n\"+\n \"
\\n\"+\n \"BokehJS does not appear to have successfully loaded. If loading BokehJS from CDN, this \\n\"+\n \"may be due to a slow or bad network connection. Possible fixes:\\n\"+\n \"
\\n\"+\n \"
\\n\"+\n \"- re-rerun `output_notebook()` to attempt to load from CDN again, or
\\n\"+\n \"- use INLINE resources instead, as so:
\\n\"+\n \"
\\n\"+\n \"
\\n\"+\n \"from bokeh.resources import INLINE\\n\"+\n \"output_notebook(resources=INLINE)\\n\"+\n \"\\n\"+\n \"
\\n\"+\n",
- " \"
\\n\"+\n",
- " \"BokehJS does not appear to have successfully loaded. If loading BokehJS from CDN, this \\n\"+\n",
- " \"may be due to a slow or bad network connection. Possible fixes:\\n\"+\n",
- " \"
\\n\"+\n",
- " \"
\\n\"+\n",
- " \"- re-rerun `output_notebook()` to attempt to load from CDN again, or
\\n\"+\n",
- " \"- use INLINE resources instead, as so:
\\n\"+\n",
- " \"
\\n\"+\n",
- " \"
\\n\"+\n",
- " \"from bokeh.resources import INLINE\\n\"+\n",
- " \"output_notebook(resources=INLINE)\\n\"+\n",
- " \"\\n\"+\n",
- " \"
\\n\"+\n \"
\\n\"+\n \"BokehJS does not appear to have successfully loaded. If loading BokehJS from CDN, this \\n\"+\n \"may be due to a slow or bad network connection. Possible fixes:\\n\"+\n \"
\\n\"+\n \"
\\n\"+\n \"- re-rerun `output_notebook()` to attempt to load from CDN again, or
\\n\"+\n \"- use INLINE resources instead, as so:
\\n\"+\n \"
\\n\"+\n \"
\\n\"+\n \"from bokeh.resources import INLINE\\n\"+\n \"output_notebook(resources=INLINE)\\n\"+\n \"\\n\"+\n \"
\\n\"+\n \"
\\n\"+\n \"BokehJS does not appear to have successfully loaded. If loading BokehJS from CDN, this \\n\"+\n \"may be due to a slow or bad network connection. Possible fixes:\\n\"+\n \"
\\n\"+\n \"
\\n\"+\n \"- re-rerun `output_notebook()` to attempt to load from CDN again, or
\\n\"+\n \"- use INLINE resources instead, as so:
\\n\"+\n \"
\\n\"+\n \"
\\n\"+\n \"from bokeh.resources import INLINE\\n\"+\n \"output_notebook(resources=INLINE)\\n\"+\n \"\\n\"+\n \"