Merge pull request #576 from devforth/next

Next

Author: ivictbor

AGENTS.md

@@ -6,6 +6,18 @@
 All packages and projects in this repo use `pnpm` and not `npm`. 
 Howeverer internally (e.g. in `codeInjector`) adminforth still supports both `npm` and `pnpm` style install commands, so users of framework itself can use it with either package manager. But in all dev demo/live demo, plugins, adapters, and documentation, we use `pnpm` as the standard.
 
+## Package names rules
+
+
+All adapters and plugins always have `@adminforth/` prefix in their package name, followed by short lowercase kebab-case plugin/adpater slug.
+
+Every plugin has at least one Docusaurus docs page, which should use the path `/docs/tutorial/Plugins/<plugin-slug>/`.
+
+Same for adapters, but with `/docs/tutorial/Adapters/<adapter-slug>/` path.
+
+Page names in docusarus should be human readabale. We should not use `AuditLog` but instead we should have `Audit Log` via whitespace.
+
+
 ## General engineering rules
 
 Write code as if the system contracts are already defined and trusted.

adminforth/documentation/docs/tutorial/03-Customization/04-hooks.md

@@ -44,7 +44,7 @@ When user opens edit page, AdminForth makes a request to the backend to get the
 
 Practically you can use `show.afterDatasourceResponse` to modify or add some data before it is displayed on the edit page. 
 
-For example [upload plugin](/docs/tutorial/Plugins/05-0-upload/) uses this hook to generate signed preview URL so user can see existing uploaded file preview  in form, and at the same time database stores only original file path which might be not accessible without presigned URL.
+For example [upload plugin](/docs/tutorial/Plugins/upload/) uses this hook to generate signed preview URL so user can see existing uploaded file preview  in form, and at the same time database stores only original file path which might be not accessible without presigned URL.
 
 ## Saving data on edit page
 

adminforth/documentation/docs/tutorial/03-Customization/10-menuConfiguration.md

@@ -277,7 +277,7 @@ auth: {
 
 ```
 
-This syntax can be use to get unique avatar for each user of hardcode avatar, but it makes more sense to use it with [upload plugin](https://adminforth.dev/docs/tutorial/Plugins/05-0-upload/#using-plugin-for-uploading-avatar)
+This syntax can be use to get unique avatar for each user of hardcode avatar, but it makes more sense to use it with [upload plugin](https://adminforth.dev/docs/tutorial/Plugins/upload/#using-plugin-for-uploading-avatar)
 
 
 ## Custom URL

adminforth/documentation/docs/tutorial/08-Plugins/01-AuditLog.md

@@ -1,3 +1,7 @@
+---
+title: Audit Log
+slug: /tutorial/Plugins/audit-log
+---
 
 AuditLog plugin allows to log all changes in the resources done from the admin panel. 
 It will allow you to figure out who and when made changes in the data. 

adminforth/documentation/docs/tutorial/08-Plugins/02-TwoFactorsAuth.md

@@ -1,3 +1,8 @@
+---
+title: Two-Factor Authentication Plugin
+slug: /tutorial/Plugins/two-factors-auth
+---
+
 # Two-Factor Authentication Plugin
 
 The Two-Factor Authentication Plugin provides an additional layer of security to the application by requiring users to provide a second form of authentication in addition to their password. This plugin supports  authenticator apps.

adminforth/documentation/docs/tutorial/08-Plugins/03-ForeignInlineList.md

@@ -1,3 +1,7 @@
+---
+title: Foreign Inline List
+slug: /tutorial/Plugins/foreign-inline-list
+---
 
 Foreign inline list plugin allows to display a list (table) of items from a foreign table in the show view.
 

adminforth/documentation/docs/tutorial/08-Plugins/04-RichEditor.md

@@ -1,3 +1,8 @@
+---
+title: Rich Editor
+slug: /tutorial/Plugins/rich-editor
+---
+
 # Rich editor
 
 Under the hood this plugin uses [Quill](https://quilljs.com/). Quill is a free, open source WYSIWYG editor built for the modern web.

adminforth/documentation/docs/tutorial/08-Plugins/05-0-upload.md

@@ -1,3 +1,8 @@
+---
+title: Upload
+slug: /tutorial/Plugins/upload
+---
+
 # Upload
 
 This plugin allows you to upload files to Amazon S3 bucket.

adminforth/documentation/docs/tutorial/08-Plugins/06-text-complete.md

@@ -1,3 +1,8 @@
+---
+title: Text Complete
+slug: /tutorial/Plugins/text-complete
+---
+
 # Text Complete
 
 This plugin allows you to auto-complete text and string fields using OpenAI GPT models via the Responses API.

adminforth/documentation/docs/tutorial/08-Plugins/07-email-password-reset.md

@@ -1,3 +1,7 @@
+---
+title: Email Password Reset
+slug: /tutorial/Plugins/email-password-reset
+---
 
 # Email password reset