{"id":24989069,"url":"https://github.com/engineervix/zm-dpa","last_synced_at":"2025-03-29T11:40:29.177Z","repository":{"id":240452230,"uuid":"802672784","full_name":"engineervix/zm-dpa","owner":"engineervix","description":"The Zambia Data Protection Act, 2021 – powered by Material for MkDocs","archived":false,"fork":false,"pushed_at":"2024-11-30T04:29:49.000Z","size":305,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-06T20:57:13.161Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://dpa.pages.dev","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gfdl-1.3","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/engineervix.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-19T00:06:24.000Z","updated_at":"2024-11-30T04:29:51.000Z","dependencies_parsed_at":"2024-05-23T07:23:14.591Z","dependency_job_id":"91d7d1cb-372f-455c-8e66-3946a4748e57","html_url":"https://github.com/engineervix/zm-dpa","commit_stats":null,"previous_names":["engineervix/zm-dpa"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engineervix%2Fzm-dpa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engineervix%2Fzm-dpa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engineervix%2Fzm-dpa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engineervix%2Fzm-dpa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/engineervix","download_url":"https://codeload.github.com/engineervix/zm-dpa/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246180898,"owners_count":20736459,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-04T12:14:34.971Z","updated_at":"2025-03-29T11:40:28.738Z","avatar_url":"https://github.com/engineervix.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# The Data Protection Act, 2021\n\n\u003e An Act to provide an effective system for the use and protection of personal data; regulate the collection, use, transmission, storage and otherwise processing of personal data; establish the Office of the Data Protection Commissioner and provide for its functions; the registration of data controllers and licencing of data auditors; provide for the duties of data controllers and data processors; provide for the rights of data subjects; and provide for matters connected with, or incidental to, the foregoing.\n\u003e\n\u003e Source: \u003chttps://www.parliament.gov.zm/node/8853\u003e\n\n[![Continuous Integration](https://github.com/engineervix/zm-dpa/actions/workflows/main.yml/badge.svg)](https://github.com/engineervix/zm-dpa/actions/workflows/main.yml)\n[![python3](https://img.shields.io/badge/python-3.12-brightgreen.svg)](https://python.org/)\n[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)\n[![Conventional Changelog](https://img.shields.io/badge/changelog-conventional-brightgreen.svg)](https://github.com/conventional-changelog)\n[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org)\n\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n\n- [Introduction](#introduction)\n  - [Why this project exists](#why-this-project-exists)\n  - [How the content was put together](#how-the-content-was-put-together)\n- [Development](#development)\n  - [First things first](#first-things-first)\n  - [Getting Started](#getting-started)\n- [Contributing](#contributing)\n- [TODO](#todo)\n- [Notice](#notice)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\n## Introduction\n\nPowered by [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/), this project transforms a traditionally dense and difficult to navigate PDF of the aforementioned _Act_ into an easily navigable, searchable, and visually appealing online resource.\n\n### Why this project exists\n\nNavigating legislative documents can be daunting and often results in a headache. This project was born out of the desire to make the process of understanding the _Act_ more approachable and less painful.\n\n### How the content was put together\n\nThis is the approach I took:\n\n1. Download the original [pdf](https://www.parliament.gov.zm/sites/default/files/documents/acts/Act%20No.%203%20The%20Data%20Protection%20Act%202021_0.pdf) from the National Assembly of Zambia website.\n2. Use [Adobe Acrobat Online PDF to Word Converter](https://www.adobe.com/uk/acrobat/online/pdf-to-word.html) to convert the pdf to a `docx` file.\n3. Use [pandoc](https://pandoc.org/) to convert the `docx` file to [Markdown](https://daringfireball.net/projects/markdown/) (based on [this gist](https://gist.github.com/plembo/409a8d7b1bae66622dbcd26337bbb185)):\n\n  ```bash\n  pandoc \\\n    -t markdown_strict \\\n    --extract-media='./attachments/source' \\\n    source.docx \\\n    -o output.md\n  ```\n\n4. Copy / paste the content, and clean up where the formatting is incorrect.\n\n\u003e [!WARNING]  \n\u003e The formatting of the Pandoc-generated output was not 100% accurate. While I have made every effort to correct formatting issues and other minor bugs, you might encounter some typos, incorrect numbering, or potentially missing content.\n\u003e\n\u003e If you notice any of these issues, please help in fixing them by [opening an issue](https://github.com/engineervix/zm-dpa/issues) or [submitting a pull request](https://github.com/engineervix/zm-dpa/pulls). Your [contributions](#contributing) are greatly appreciated.\n\u003e\n\u003e Gracias\n\n## Development\n\n### First things first\n\nYou need to have [Python 3.12](https://www.python.org/) and [Poetry](https://python-poetry.org/) installed on your machine. If, for some reason, you have a different python version, you can use [pyenv](https://github.com/pyenv/pyenv) to install multiple python versions on your machine. Once you have Python 3.12 installed, create a [**virtual environment**](https://realpython.com/python-virtual-environments-a-primer/).\n\n\u003e [!NOTE]  \n\u003e If you have a different Python version and/or you don't have Poetry, try installing the python dependencies via `pip install -r requirements.txt`\n\n### Getting Started\n\nHere, we assume that you have `git` on your machine, and that you have created a Python 3.12 virtual environment.\n\nNow, upon cloning this repository (or forking + cloning your fork), navigate to the cloned project directory.\n\n1. In your [**virtual environment**](https://realpython.com/python-virtual-environments-a-primer/), install Python dependencies\n\n   ```bash\n   poetry install\n   ```\n\n2. Run the following in your shell:\n\n   ```bash\n   mkdocs serve\n   ```\n\n   The documentation will be available at: \u003chttp://127.0.0.1:8001/\u003e\n\n## Contributing\n\n\u003c!-- Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)): --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\n\u003c!-- markdownlint-restore --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions are most welcome! A good place to start is by helping out with the unchecked items in the [TODO](#todo) section of this README!\n\nFeel free to check the [issues page](https://github.com/engineervix/zm-dpa/issues) and take a look at the [contributing guide](https://github.com/engineervix/zm-dpa/blob/main/CONTRIBUTING.md) before you get started.\n\n## TODO\n\n- [ ] where reference is made to other sections, use hyperlinks to link to those sections\n\n## Notice\n\nI do not own the copyright to the contents of the aforementioned _Act_. The text of the _Act_ is a public document, and this project aims to make it more accessible and user-friendly. Any modifications or enhancements to the presentation are my own work, and permission is granted to copy, distribute and/or modify this work under the terms of the GNU Free Documentation License as published by the Free Software Foundation, either version 1.3, or (at your option) any later version; with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts. A copy of the license is contained in the file `COPYING`.\n\n---","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fengineervix%2Fzm-dpa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fengineervix%2Fzm-dpa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fengineervix%2Fzm-dpa/lists"}