docs: add user-friendly README changes for new developers (#10, #11)

This commit is contained in:
rzmk 2025-10-14 06:13:55 -04:00
parent 65aff22b99
commit 9a74c987ee

View file

@ -1,14 +1,33 @@
# ckan-devstaller # ckan-devstaller
`ckan-devstaller` attempts to install CKAN 2.11.3 from source using [ckan-compose](https://github.com/tino097/ckan-compose), intended for development use in a new Ubuntu 22.04 instance. `ckan-devstaller` attempts to install a CKAN instance using [ckan-compose](https://github.com/tino097/ckan-compose) for development usage in a new Ubuntu 22.04 instance.
Get started at [ckan-devstaller.dathere.com](https://ckan-devstaller.dathere.com). You may find `ckan-devstaller` useful for:
## Quick start - Exploring CKAN for the first time without spending hours on installation steps
- Developing/Testing CKAN extensions and fixing bugs
- Trying a new CKAN version to test an upgrade from a legacy version
Please visit [ckan-devstaller.dathere.com/docs/quick-start](https://ckan-devstaller.dathere.com/docs/quick-start) for how to get started with ckan-devstaller. `ckan-devstaller` was made to help speed up the installation time for CKAN and various extensions/features to boost development productivity.
## Demos **Get started at [ckan-devstaller.dathere.com](https://ckan-devstaller.dathere.com).**
## Learn more about developing with CKAN
You may find the following guides useful while developing with CKAN:
- [CKAN Hardware Requirements](https://github.com/ckan/ckan/wiki/Hardware-Requirements) - Learn what you need before installing CKAN
- [CKAN Sysadmin guide](https://docs.ckan.org/en/latest/sysadmin-guide.html) - Useful for CKAN instance administrators/sysadmins
- [CKAN Theming guide](https://docs.ckan.org/en/latest/theming/index.html) - Explore how to set up custom themes for your CKAN instance
- [CKAN Extending guide](https://docs.ckan.org/en/latest/extensions/index.html) - Develop CKAN extensions that can enhance your CKAN instance's functionality and add custom features
## What next?
- [Customize your config file](https://docs.ckan.org/en/latest/extensions/index.html)
- [Create test data](https://docs.ckan.org/en/latest/maintaining/getting-started.html#creating-test-data)
- [Visit ckan.org](https://ckan.org)
## `ckan-devstaller` demos
### Interactive customizable installation ### Interactive customizable installation