docs_code
Code comments, JSDoc/TSDoc ve changelog best practices.
>_
Quick Installnpxskills add vuralserhat86/antigravity-agentic-skills--skill docs_codeInstructions
Loading…
Code comments, JSDoc/TSDoc ve changelog best practices.
npxskills add vuralserhat86/antigravity-agentic-skills--skill docs_codeLoading…
Code documentation ve changelog best practices.
/**
* Calculates total price including tax.
*
* @param amount - Base amount before tax
* @param taxRate - Tax rate as decimal (0.18 = 18%)
* @returns Total amount including tax
*
* @example
* const total = calculateTotal(100, 0.18); // 118
*/
function calculateTotal(amount: number, taxRate: number): number {
return amount * (1 + taxRate);
}
// ❌ What (kod zaten söylüyor)
// Increment counter by 1
counter++;
// ✅ Why (neden böyle yapıldığını açıklıyor)
// Using setTimeout to debounce API calls
setTimeout(() => saveChanges(), 500);
// ✅ Business logic
// Premium users get 20% discount (JIRA-1234)
if (user.isPremium) discount = 0.20;
## [1.2.0] - 2025-01-15
### Added
- OAuth2 authentication
### Fixed
- Login button on mobile
### Security
- Patched XSS vulnerability
feat(auth): add Google OAuth
fix(api): handle null response
docs(readme): add installation
refactor(utils): simplify logic
Docs Code v1.1 - Enhanced
Kaynak: TSDoc Standard & Keep a Changelog
/** ... */) yaz.// Optimize for ...).@example bloğu ekle.[Unreleased] başlığı altına ekle.feat:, fix:, docs:) kullan.feat(auth):).| Aşama | Doğrulama |
|---|---|
| 1 | IDE'de fonksiyon üzerine gelince TSDoc çıkıyor mu? |
| 2 | Changelog'da tarih formatı ISO 8601 (YYYY-MM-DD) mi? |
| 3 | Commit mesajı "ne" ve "neden" sorularını cevaplıyor mu? |
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).