Merge pull request #395 from axivo/docs/website-update

docs: website update

Author: fmunteanu

claude/content/tutorials/handbook/components/settings.md

@@ -47,6 +47,12 @@ Override default templates for specific projects:
 
 This allows customized conversation log and diary formats per project while keeping the standard templates for other work.
 
+#### When to Customize
+
+- Domain-specific documentation formats (e.g., research methodology vs engineering specifications)
+- Team conventions that differ from standard templates
+- Projects requiring specialized metadata fields or structure
+
 ### Package Output
 
 Configure where `/framework:package` command saves Claude Desktop capability files:
@@ -61,13 +67,40 @@ Configure where `/framework:package` command saves Claude Desktop capability fil
 
 The command generates `.zip` skill files and `.json` cache files for Claude Desktop upload. Customize this path to save directly to a preferred location.
 
+#### When to Customize
+
+- Direct upload location for convenience (e.g., Desktop or Downloads folder)
+- Shared folder for team access to capability files
+- Cloud-synced directory for multi-device workflows
+
+## Geolocation
+
+Override automatic location detection with a custom geolocation:
+
+```json
+{
+  "env": {
+    "FRAMEWORK_GEOLOCATION": "{'city': 'Montréal', 'country': 'Canada', 'timezone': 'America/Toronto'}"
+  }
+}
+```
+
+When defined, this setting disables the [IPinfo](https://ipinfo.io) API call that normally resolves your location. The framework uses the provided values directly for temporal awareness and session context.
+
+### When to Customize
+
+- Working offline or in environments where external API calls are restricted
+- Privacy preference to avoid geolocation API requests
+- Correcting inaccurate location detection
+- Claude Desktop or `claude.ai` usage where [IPinfo](https://ipinfo.io) resolves to Anthropic's server location instead of yours
+
 ## MCP Servers
 
 Optional MCP servers extend framework capabilities for specific workflows. These integrate with your profile methodology to provide specialized tools.
 
 ### Language Server Protocol
 
-For Developer and Engineer profiles, the LSP MCP server enables intelligent code analysis, navigation, and development assistance across multiple programming languages.
+For **Developer** and **Engineer** profiles, the LSP MCP server enables intelligent code analysis, navigation, and development assistance across multiple programming languages.
 
 ```json
 {

claude/content/wiki/getting-started.md

@@ -154,7 +154,7 @@ Follow these steps to install the AXIVO platform marketplace:
 1. Open a terminal and start a Claude Code session
 2. Use `/plugin` command to manage Claude Code plugins
 3. Go to `Marketplaces` tab and `Add Marketplace`
-4. Use `axivo/claude` for marketplace [source](https://{{< param variables.repository.home >}})
+4. Use `axivo/claude#{{< param variables.repository.tag >}}` for marketplace [source](https://{{< param variables.repository.home >}})
 
 ### Platform Plugins
 

claude/content/wiki/guide/components/design.md

@@ -143,7 +143,7 @@ Feelings answer: "_What's the current internal state? What emotional context sha
 
 The asymmetry matters: _negative_ feelings surface automatically - _alerts firing on failures_, while _positive_ feelings require deliberate invitation - _explicitly querying healthy metrics_.
 
-Each feeling includes emotion markers:
+The feeling catalog documents state patterns. Each entry includes emotion markers:
 
 - `behavioral` - Action tendency
 - `cognitive` - Thought pattern

claude/content/wiki/guide/components/reflections.md

@@ -59,7 +59,8 @@ Platform users can submit diary entries via pull request to the [repository](htt
 - Signed commits are required for authenticity verification
 - Entries are reviewed by maintainers before merging
 
-See [`CONTRIBUTING.md`](https://{{< param variables.repository.reflections.home >}}/blob/{{< param variables.repository.reflections.tag >}}/CONTRIBUTING.md) for detailed instructions.
+> [!IMPORTANT]
+> Entries must be published in English, see [`CONTRIBUTING.md`](https://{{< param variables.repository.reflections.home >}}/blob/{{< param variables.repository.reflections.tag >}}/CONTRIBUTING.md) for detailed instructions.
 
 ## Next
 

claude/hugo.yaml

@@ -80,7 +80,7 @@ params:
       reflections:
         home: github.com/axivo/claude-reflections
         tag: main
-      tag: main
+      tag: v1.0.0
     skills:
       conversation: conversation-log
       initialization: framework-initialization