Comments (14)
Remaining to do:
- Update session writeup in user guide
- Update contribution guide
- Move reference docs from user guide to API docs ... agreed to leave this for now
- Contrast our style guide vs PSR-1 and PSR-2
- Contrast our loading vs PSR-4
- Document security practices plan <"real" doc is separate issue for pre-alpha 2>
- Document the roadmap or the roadmap process -> JLP
- Document "Running from the CLI"
- Document "Managing Multiple Applications"
- Document "Multiple Environments"
- At least a simple writeup on CI4 "internals", to guide contributions
- Rework the "Upgrading from 3.x to 4.x page" in the installation section
New docs needed:
- Debugging - Kint and the Debug Toolbar
- Content Negotiation
- Headers in Incoming Request
- Security library (CSRF)
- Headers in Response
- Content Security Policy in Response
- Uploaded Files (FileCollection and UploadeFile classes)
- URI library
from codeigniter4.
I added a couple of the pages that need to be written to that list, just so that we can keep it to a single spot.
Over the last week or so, I've been going through each page from the top down trying to ensure it all matches the current stuff, plus has consistent formatting with certain things (like bold for file paths), and writing additional pages that don't yet have content.
Oh - and FYI- we should be 100% compatible with PSR4 autoloading. If not, let me know and I'll tweak, but I'm pretty sure we are.
from codeigniter4.
Good to see additions! :)
I suspect we are compatible with PSR-4, but with our own extensions, and I think that merits explanation.
from codeigniter4.
I suspect we are compatible with PSR-4, but with our own extensions, and I think that merits explanation.
Good point. Also, we should probably have something that describes the file-naming scheme. I'm sure that exists in the CI3 docs somewhere but don't think there was ever a single spot that said, "This is how it's done and why".
from codeigniter4.
I've added the Multiple Environments docs, but it wouldn't hurt to revisit this and expand a little bit in the future with a little bit more of a tutorial feel.
from codeigniter4.
What type of information were you thinking of in the "internals" guide?
from codeigniter4.
I am pretty sure that everything will need revisiting!
"Internals guide" ... basically what a developer would need to know, beyond the style guide, to create a package/class or extend one
- namespace conventions (do we have specific places we want to put stuff?)
- how such a package would fit in (eg updating Config\AutoloadConfig?)
- unit testing expectations (eg all public or protected methods, not just "how to", which is in tests/readme)
- interface/abstract/concrete class expectations/guideline?
from codeigniter4.
I'll tackle the internals guide, then, unless you wanted to to become more familiar with it.
from codeigniter4.
That would be great, thanks :)
I am reviewing the other new pages, and plan to add some caveats & dire warnings to the main readme :-/
from codeigniter4.
The internals page is in place now. I've got some more work to do on existing "Libraries" but we're getting close!
from codeigniter4.
Well drats. :)
I just went through the code and tried to match everything up and make sure it's been discussed, and found 8 more things that need documenting. Most of them are from scratch, but there are a couple we can take from CI3 and modify.
I'll be on vacation from June 8th-13th so it might not be until end of the month before we can do the "pre-alpha" release.
from codeigniter4.
Good catch! Better to catch it now rather than once it is out the door :-/
If the "pre-alpha" isn't ready until the second half of the month, so be it.
Thank you so much for all your hard work!!
I will continue to chip away at my end. I won't be going away on vacation until August, but I have some heavy workshops June 7-14, which will cramp my availability.
from codeigniter4.
I've wrapped up the last of the docs items. At least, it's all good enough for now. :) The upgrading page can wait because a) we don't want to encourage it and b) I think this will be a completely different sort of upgrade guide...
from codeigniter4.
Alright! A few more loose ends and we should be ready to wrap pre-alpha1!
from codeigniter4.
Related Issues (20)
- Bug(SQLite3): Forge::dropColumn() seems to always return false HOT 1
- Bug: [DatetimeCast] Invalid parameter: nullable HOT 3
- Bug: CLI class, method promptByMultipleKeys() - default $input is of wrong type HOT 1
- Bug: No DBPrefix or backticks inside SQL functions in QueryBuilder HOT 16
- Bug: Can not header reponse as file image HOT 2
- Bug: [View Cells] Too few arguments to function App\Cells\MyClass::myMethod(), 0 passed in HOT 3
- Bug: CodeIgniter\Controller::validateData will throw error if first paramter is not an empty array for file upload validation HOT 4
- Bug: language fallback doesn't kick in if message if empty HOT 5
- Bug: Session FileDriver unlink No such file or directory HOT 1
- feat: Command `lang:find` behavior with parameters
- Bug: Credit card validation does not work with multiple card HOT 1
- Bug: postgre can not connect to database error HOT 12
- `Model::paginate()` behavior when `$page` exceeds the last page HOT 12
- Bug: CodeIgniter v4.5.1 When I connect Postgres Database I Received Error HOT 4
- Bug: [Error] Call to undefined method Config\Mimes::__set_state() at ROOTPATH/writable/cache/FactoriesCache_config HOT 7
- Bug: [DebugBar] Flush a session flash-data when redirect by "Refresh" method HOT 2
- Add required_if validation rules
- Bug: Entity Standalone Class initialization error HOT 2
- Bug: How can I know which browser name is the request from?
- Bug: How can I know which browser name is the request from? HOT 14
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from codeigniter4.