@maccesar/titools 2.2.4 → 2.2.8

package/skills/ti-guides/references/resources.md

@@ -1,129 +1,121 @@
-# Titanium Resources
+# Titanium resources
 
 Community resources, support channels, tools, and learning materials for Titanium developers.
 
-1. [Developer Support](#developer-support)
-2. [Example Code](#example-code)
-3. [Community Modules](#community-modules)
-4. [Social Media](#social-media)
-5. [Learning Resources](#learning-resources)
+## Developer support
 
----
-
-## Developer Support
-
-### Official Channels
+### Official channels
 
-- **[GitHub Discussions](https://github.com/tidev/titanium-sdk/discussions)** - Post questions and get help from the community
-- **[Slack](https://tidev.slack.com/)** - Titanium SDK Community Slack (help, jobs, announcements)
+- GitHub Discussions: https://github.com/tidev/titanium-sdk/discussions
+- Slack: https://tidev.slack.com/
   - Join at: https://tidev.slack.com/
   - Channels for help, modules, announcements, and more
 
-### Module Resources
+### Module resources
 
-- **[Module Search](https://modules.titaniumsdk.com/)** - Search for Titanium modules
-- **[Ti.Utils](https://github.com/TimanMax/Ti.Utils)** - Collection of utilities
-- **[From Zero to App](https://fromzerotoapp.com/)** - Tutorials and modules
+- Module Search: https://modules.titaniumsdk.com/
+- Ti.Utils: https://github.com/TimanMax/Ti.Utils
+- From Zero to App: https://fromzerotoapp.com/
 
 ### Documentation
 
-- **[Titanium SDK Docs](https://titaniumsdk.com/)** - Official API documentation
-- **[Alloy Framework Docs](https://titaniumsdk.com/guide/Alloy_Framework/)** - Alloy MVC framework guide
-- **[This Skill (ti-guides)](../SKILL.md)** - Best practices and architecture
+- Titanium SDK Docs: https://titaniumsdk.com/
+- Alloy Framework Docs: https://titaniumsdk.com/guide/Alloy_Framework/
+- This skill (`ti-guides`): `../SKILL.md`
 
 ---
 
-## Example Code
+## Example code
 
-### Official Repositories
+### Official repositories
 
-- **[tidev on GitHub](https://github.com/tidev)** - Titanium source code, modules, and sample apps
-  - **[titanium-mobile](https://github.com/tidev/titanium-mobile)** - Titanium SDK source
-  - **[titanium-cli](https://github.com/tidev/titanium-cli)** - Titanium CLI
-  - **[titanium-code-processor](https://github.com/tidev/titanium-code-processor)** - Code processor for Alloy
+- tidev on GitHub: https://github.com/tidev
+  - titanium-mobile: https://github.com/tidev/titanium-mobile
+  - titanium-cli: https://github.com/tidev/titanium-cli
+  - titanium-code-processor: https://github.com/tidev/titanium-code-processor
 
-### Sample Applications
+### Sample applications
 
-- **[Ti.Bluetooth](https://github.com/mwaylabs/ti.bluetooth)** - Bluetooth LE module
-- **[Ti.Map](https://github.com/tidev/ti.map)** - Native maps module
-- **[KitchenSink](https://github.com/tidev/KitchenSink)** - Comprehensive API examples
+- Ti.Bluetooth: https://github.com/mwaylabs/ti.bluetooth
+- Ti.Map: https://github.com/tidev/ti.map
+- KitchenSink: https://github.com/tidev/KitchenSink
 
-### Community Projects
+### Community projects
 
-Search GitHub for "titanium" to find thousands of open source modules and apps.
+Search GitHub for "titanium" to find open source modules and apps.
 
 ---
 
-## Community Modules
+## Community modules
 
-### Finding Modules
+### Finding modules
 
-1. **[Module Search](https://modules.titaniumsdk.com/)** - Official module registry
-2. **[npm](https://www.npmjs.com/search?q=titanium)** - NPM packages for Titanium
-3. **[GitHub](https://github.com/search?q=titanium+module)** - Search GitHub
+1. Module Search: https://modules.titaniumsdk.com/
+2. npm: https://www.npmjs.com/search?q=titanium
+3. GitHub search: https://github.com/search?q=titanium+module
 
-### Creating Modules
+### Creating modules
 
-See **`hyperloop-native-access.md`** for native module development:
+See `hyperloop-native-access.md` for native module development:
 - Android modules (Java/Kotlin)
 - iOS modules (Objective-C/Swift)
 - Module packaging and distribution
 
-### Popular Modules
+### Popular modules
 
-- **ti.map** - Native maps (iOS & Android)
-- **ti.admob** - AdMob ads
-- **ti.imagefactory** - Image processing
-- **ti.facebook** - Facebook integration
-- **ti.media** - Extended media APIs
+- ti.map: native maps (iOS and Android)
+- ti.admob: AdMob ads
+- ti.imagefactory: image processing
+- ti.facebook: Facebook integration
+- ti.media: extended media APIs
 
 ---
 
-## Social Media
+## Social media
 
-### Official Accounts
+### Official accounts
 
-- **Bluesky:** [@titaniumsdk.com](https://bsky.app/profile/titaniumsdk.com) - SDK and CLI updates
-- **X (Twitter):**
-  - [@tidevio](https://x.com/tidevio) - Foundation account
-  - [@TitaniumSDK](https://x.com/TitaniumSDK) - SDK updates
+- Bluesky: https://bsky.app/profile/titaniumsdk.com
+- X (Twitter):
+  - https://x.com/tidevio
+  - https://x.com/TitaniumSDK
 
 ### Community
 
-- **[r/titanium](https://www.reddit.com/r/titanium/)** - Reddit community
-- **[Stack Overflow](https://stackoverflow.com/questions/tagged/titanium)** - Q&A
+- Reddit: https://www.reddit.com/r/titanium/
+- Stack Overflow: https://stackoverflow.com/questions/tagged/titanium
 
 ---
 
-## Learning Resources
+## Learning resources
 
-### Getting Started
+### Getting started
 
-1. **Hello World** - See `hello-world.md` in this skill
-2. **JavaScript Primer** - See `javascript-primer.md` in this skill
-3. **Alloy Framework** - See `alloy-guides` skill
-4. **Sample Apps** - Clone and study KitchenSink
+1. Hello World: see `hello-world.md` in this skill
+2. JavaScript Primer: see `javascript-primer.md` in this skill
+3. Alloy Framework: see the `alloy-guides` skill
+4. Sample apps: clone and study KitchenSink
 
-### Books and Guides
+### Books and guides
 
-- **Titanium Up & Running** - Build native apps with JavaScript
-- **Titanium Pocket Reference** - Quick API guide
-- **Alloy Guides** - Official Alloy framework documentation
+- Titanium Up & Running
+- Titanium Pocket Reference
+- Alloy Guides (official Alloy framework documentation)
 
-### Video Tutorials
+### Video tutorials
 
-- **[From Zero to App](https://fromzerotoapp.com/)** - Video tutorials
-- **[YouTube](https://www.youtube.com/results?search_query=titanium+mobile)** - Community tutorials
+- From Zero to App: https://fromzerotoapp.com/
+- YouTube results: https://www.youtube.com/results?search_query=titanium+mobile
 
 ---
 
 ## Tools and IDEs
 
-### IDE Support
+### IDE support
 
-- **[VS Code](https://code.visualstudio.com/)** - With Titanium extensions
+- VS Code: https://code.visualstudio.com/ (with Titanium extensions)
 
-### CLI Tools
+### CLI tools
 
 ```bash
 # Create new project
@@ -139,35 +131,35 @@ ti build -p android
 ti build -T device
 ```
 
-See **`cli-reference.md`** for complete CLI documentation.
+See `cli-reference.md` for complete CLI documentation.
 
 ---
 
 ## Contributing
 
-### Report Bugs
+### Report bugs
 
-- **[GitHub Issues](https://github.com/tidev/titanium-sdk/issues)** - Bug reports
-- **[JIRA Archive](https://github.com/tidev/jira-archive)** - Legacy issue tracker (Appcelerator)
+- GitHub Issues: https://github.com/tidev/titanium-sdk/issues
+- JIRA Archive: https://github.com/tidev/jira-archive
 
-### Contribute Code
+### Contribute code
 
-- **[Pull Request Guide](https://github.com/tidev/titanium-mobile/blob/master/CONTRIBUTING.md)** - Contributing guidelines
-- Follow coding standards (see **`style-and-conventions.md`**)
+- Pull Request Guide: https://github.com/tidev/titanium-mobile/blob/master/CONTRIBUTING.md
+- Follow coding standards in `style-and-conventions.md`
 
 ---
 
-## Best Practices for Getting Help
+## Best practices for getting help
 
-1. **Search first** - Check docs, GitHub issues, Stack Overflow
-2. **Be specific** - Include code, error messages, platform info
-3. **Provide minimal reproducible example** - Isolate the problem
-4. **Use Slack for quick questions** - GitHub Discussions for deeper discussions
-5. **Give back** - Help others when you can
+1. Search first: check docs, GitHub issues, Stack Overflow.
+2. Be specific: include code, error messages, and platform info.
+3. Provide a minimal reproducible example.
+4. Use Slack for quick questions and GitHub Discussions for longer threads.
+5. Give back when you can.
 
 ---
 
-## Resource Checklist
+## Resource checklist
 
 For new Titanium developers:
 

package/skills/ti-guides/references/style-and-conventions.md

@@ -1,21 +1,24 @@
-# Style and Conventions Reference
+# Style and conventions reference
 
-## 1. Naming Conventions
-- **Variables**: `nounCategory` (e.g., `personName`, `buttonSubmit`).
-- **Functions**: `verbCategory` (e.g., `getPersonName`, `doSync`).
-- **Classes/Constructors**: `PascalCase` (e.g., `User`, `NetClient`).
-- **Factories**: Prefix with `create` (e.g., `createWidget`).
-- **Namespaces**: Use capitalized words (e.g., `App.UI.Widget`, `App.Network.Request`). Avoid lowercase for major namespaces (e.g., use `App.UI` instead of `app.ui`).
-- **Hungarian Notation**: Titanium SDK does not support the use of Hungarian Notation.
+## 1. Naming conventions
 
-## 2. Language Rules
-- **Semicolons**: Always use semicolons to terminate statements. This is mandatory in official SDK guides, but **omitted** in the `ti-expert` standard (let ASI handle it).
-- **`this` keyword**: Use `this` with extreme care, as it sometimes doesn't refer to the object you expect.
+- Variables: `nounCategory` (for example, `personName`, `buttonSubmit`).
+- Functions: `verbCategory` (for example, `getPersonName`, `doSync`).
+- Classes/constructors: `PascalCase` (for example, `User`, `NetClient`).
+- Factories: prefix with `create` (for example, `createWidget`).
+- Namespaces: use capitalized words (for example, `App.UI.Widget`, `App.Network.Request`). Avoid lowercase for major namespaces (use `App.UI`, not `app.ui`).
+- Hungarian notation: not supported by the Titanium SDK.
+
+## 2. Language rules
+
+- Semicolons: official SDK guides require semicolons, but the `ti-expert` standard omits them and lets ASI handle it.
+- `this` keyword: use with care. It may not refer to the object you expect.
 
 ## 3. Formatting
-- **Indentation**: Both K&R/1TBS and Allman styles are acceptable. Consistency is most important — never mix styles in the same project.
+
+- Indentation: both K&R/1TBS and Allman styles are acceptable. Consistency matters. Do not mix styles in the same project.
 ```javascript
-// K&R/1TBS Style
+// K&R/1TBS style
 if (x < 10) {
   if (y > 10) {
     // do this
@@ -25,7 +28,7 @@ if (x < 10) {
 }
 ```
 ```javascript
-// Allman Style
+// Allman style
 if (x < 10)
 {
   if (y > 10)
@@ -38,28 +41,29 @@ else
   // do this
 }
 ```
-- **Operators**: Add a single space around operators.
+- Operators: add a single space around operators.
 ```javascript
 const fullName = firstName + ' ' + lastName
 ```
 
-**CRITICAL: Return Statement Placement**
-Never put `return` on its own line followed by an object literal. JavaScript will insert a semicolon automatically, returning `undefined`.
+Return statement placement:
+Do not put `return` on its own line followed by an object literal. JavaScript will insert a semicolon automatically and return `undefined`.
 ```javascript
-// ❌ WRONG
+// Wrong
 return
 {
   foo: 'bar'
 }
 
-// ✅ CORRECT
+// Correct
 return {
   foo: 'bar'
 }
 ```
 
-## 4. Control Statements
-- Switch statements should have a single space before the opening parenthesis and a single space after the closing parenthesis. Switch content is indented with one tab; content in each case is indented one tab as well.
+## 4. Control statements
+
+Switch statements should have a single space before the opening parenthesis and a single space after the closing parenthesis. Switch content is indented with one tab; content in each case is indented one tab as well.
 ```javascript
 switch (someTest) {
     case 1:
@@ -73,13 +77,15 @@ switch (someTest) {
 }
 ```
 
-## 5. Primitive Types
-- Avoid using primitive type object constructors (e.g., `new String()`).
-- Use template literals or single space concatenation.
+## 5. Primitive types
 
-## 6. Comments and Documentation
-- **Single-line comments**: Required to reduce programmer error. Inline statement comments should be used at a minimum or not at all.
-- **JSDoc/Block comments**: Required for documenting functions and classes.
+- Avoid using primitive type object constructors (for example, `new String()`).
+- Use template literals or single-space concatenation.
+
+## 6. Comments and documentation
+
+- Single-line comments: required to reduce programmer error. Inline statement comments should be used at a minimum or not at all.
+- JSDoc/block comments: required for documenting functions and classes.
 ```javascript
 // Calculate position using initial
 // and offset x coordinates.
@@ -92,5 +98,6 @@ function getCustomer(customerName) {}
 ```
 
 ## 7. References
+
 - Douglas Crockford's JavaScript Code Conventions
-- Google's JavaScript Style Guide (https://google.github.io/styleguide/jsguide.html)
+- Google's JavaScript Style Guide: https://google.github.io/styleguide/jsguide.html