@vantagesec/socc 0.1.13 → 0.1.15

package/socc-canonical/.agents/soc-copilot/skills/translation-expertise/english.md

@@ -1,372 +0,0 @@
-# English Language Reference for Translation
-
-This document contains comprehensive information about English language characteristics, conventions, and considerations relevant to translation work.
-
-## Core Characteristics
-
-### Structural Features
-
-- **Word Order**: Subject-Verb-Object (SVO) - relatively fixed structure
-- **Subject Pronouns**: Explicit subject pronouns required in most cases (except imperatives)
-- **Articles**: Definite (the) and indefinite (a, an) articles indicate specificity
-- **Communication Style**: Direct communication style generally preferred
-- **Voice Preference**: Active voice generally preferred over passive voice
-- **Tense System**: Verb tenses explicitly indicate time relationships
-
-### Linguistic Features
-
-- **Fixed Word Order**: Less flexible than Japanese/Chinese; word order changes meaning
-- **Prepositions**: Indicate spatial, temporal, and abstract relationships (in, on, at, by, with, from, to)
-- **Auxiliaries**: Auxiliary verbs for questions and negatives (do, does, did)
-- **Modal Verbs**: Convey important nuance (may, might, could, should, would, must, can, will)
-- **Phrasal Verbs**: Common compound expressions (pick up, put off, get over, figure out)
-- **Vocabulary Layers**: Germanic and Latin/French roots create formal/informal vocabulary pairs
-  - Germanic: buy, help, begin, end
-  - Latin/French: purchase, assist, commence, terminate
-
-### Grammatical Features
-
-- **Verb Conjugation**: Verbs conjugate for person, number, and tense
-- **Plural Markers**: Nouns typically marked for singular/plural (book/books)
-- **Grammatical Gender**: No grammatical gender (unlike many European languages)
-- **Relative Clauses**: Can be restrictive (no commas) or non-restrictive (with commas)
-- **Gerunds and Infinitives**: Both forms common with different usage patterns
-
-## Translation Considerations
-
-### From English to Japanese/Chinese
-
-**Common Challenges**:
-
-1. **Verbosity**: English can be more verbose than target languages - condensing may be necessary
-2. **Idioms**: Often don't translate directly - find cultural equivalents
-3. **Pronoun Clarity**: Japanese/Chinese may omit subjects - ensure clarity is maintained
-4. **Modal Verb Nuance**: Careful interpretation needed (may vs. might vs. could)
-5. **Passive Voice**: May need restructuring in target language
-6. **Articles**: No direct equivalent in Japanese/Chinese; meaning must be conveyed through context
-
-**Key Strategies**:
-
-- **Simplify sentence structure** where possible while maintaining meaning
-- **Replace idioms** with culturally equivalent expressions in target language
-- **Make implicit information explicit** if target language requires it
-- **Choose appropriate formality level** based on English register indicators
-- **Consider cultural adaptation** for references unfamiliar to target audience
-
-### To English from Japanese/Chinese
-
-**Common Challenges**:
-
-1. **Subject Addition**: May require adding explicit subjects where source omits them
-2. **Article Selection**: Need to choose appropriate articles (a/an/the)
-3. **Making Implicit Explicit**: Implied information may need to be stated directly
-4. **Honorific Conversion**: Translate politeness levels through appropriate English equivalents
-5. **Formality Expression**: Express through vocabulary rather than grammar
-6. **Pronoun Usage**: Choose appropriate pronouns where source language omits them
-
-**Key Strategies**:
-
-- **Add subjects** where necessary for grammatical correctness and clarity
-- **Choose articles** based on definiteness and context
-- **Use titles and polite language** to convey honorifics (Mr., Dr., esteemed, valued)
-- **Select formal/informal vocabulary** to match source register
-- **Expand condensed expressions** to full English phrases where needed
-- **Clarify ambiguous references** that are clear in source context
-
-## Formality Indicators
-
-### Informal Register
-
-**Characteristics**:
-
-- Contractions: don't, can't, won't, I'm, you're, they've
-- Simple vocabulary: buy, help, get, ask, make, use
-- Personal pronouns: you, I, we (frequent use)
-- Short, direct sentences
-- Colloquialisms and slang
-- Phrasal verbs: figure out, come up with, get through
-
-**Example**: "Let me know if you've got any questions about this."
-
-### Standard Register
-
-**Characteristics**:
-
-- Minimal contractions (context-dependent)
-- Standard vocabulary: obtain, provide, receive, inquire
-- Balanced sentence length
-- Professional but accessible tone
-- Limited use of phrasal verbs
-
-**Example**: "Please let me know if you have any questions about this matter."
-
-### Formal Register
-
-**Characteristics**:
-
-- No contractions: do not, cannot, will not, I am
-- Sophisticated vocabulary: purchase, assist, obtain, ascertain, utilize
-- Passive voice more common: "It is recommended that..."
-- Complex sentence structures with subordinate clauses
-- Technical or literary terms
-- Latin-derived vocabulary preferred
-- Modal verbs for politeness: "would appreciate," "kindly consider"
-
-**Example**: "Please do not hesitate to contact me should you have any inquiries regarding this matter."
-
-### Academic/Technical Register
-
-**Characteristics**:
-
-- Extremely formal vocabulary: commence, terminate, facilitate
-- Passive voice frequent: "The results were analyzed..."
-- Complex noun phrases: "the implementation of the revised protocol"
-- Hedging language: "it appears that," "the findings suggest"
-- Nominalization: "the analysis" instead of "analyzing"
-- Third person perspective
-
-**Example**: "It has been determined that further investigation is warranted."
-
-## Punctuation Conventions
-
-### Basic Punctuation
-
-**Period (.)**:
-
-- End of declarative sentences
-- After abbreviations (Dr., etc., Inc.)
-- In decimals (3.14, $5.99)
-
-**Comma (,)**:
-
-- Separating items in a list (Oxford comma optional but recommended)
-- After introductory phrases
-- Around non-essential clauses
-- Before coordinating conjunctions in compound sentences (and, but, or, so)
-- After transitional phrases
-
-**Semicolon (;)**:
-
-- Connecting closely related independent clauses
-- Separating items in complex lists (when items contain commas)
-
-**Colon (:)**:
-
-- Introducing lists
-- Before explanations or examples
-- In time notation (3:30 PM)
-- After salutation in formal letters (Dear Sir:)
-
-### Quotation Marks
-
-**Double Quotes ("")**:
-
-- Primary quotations
-- Direct speech
-- Titles of short works (articles, songs, poems, TV episodes)
-- Scare quotes for irony or unusual usage
-
-**Single Quotes ('')**:
-
-- Quotes within quotes
-- Less common in American English
-
-**American vs. British Style**:
-
-- **American**: Periods and commas go inside closing quotes
-  - Example: He said, "Hello."
-- **British**: Periods and commas go outside closing quotes (unless part of quote)
-  - Example: He said, 'Hello'.
-
-**Other Punctuation with Quotes**:
-
-- Colons and semicolons go outside closing quotes
-- Question marks and exclamation points depend on context
-
-### Other Marks
-
-**Apostrophe (')**:
-
-- Possessive case (John's book, the cat's toy)
-- Contractions (don't, can't, it's)
-- Plural of letters and numbers (A's, 1990's - though controversial)
-
-**Dashes**:
-
-- **Em dash (—)**: Interruption, emphasis, or parenthetical remark (no spaces in US style)
-- **En dash (–)**: Ranges (2020–2023, pages 10–15)
-- **Hyphen (-)**: Compound words (mother-in-law, well-known)
-
-**Ellipsis (...)**:
-
-- Three dots with spaces between
-- Trailing off in speech
-- Omission in quoted text
-- Pause or hesitation
-- Four dots if ending a sentence (period + ellipsis)
-
-**Parentheses ()**:
-
-- Additional information
-- Asides or clarifications
-- Acronym explanations: "Central Intelligence Agency (CIA)"
-
-**Brackets []**:
-
-- Editorial insertions in quotes: "She [the president] announced..."
-- Clarifications in quoted material
-
-**Slash (/)**:
-
-- Alternatives (and/or)
-- Fractions (1/2)
-- Dates in informal writing (12/25/2023)
-- Line breaks in quoted poetry
-
-## Writing Notes for Translators
-
-### Common Translation Pitfalls
-
-1. **False Friends**: Words that look similar in other languages but mean different things
-2. **Phrasal Verbs**: Often difficult to translate idiomatically
-3. **Cultural References**: Sports metaphors, holidays, historical events
-4. **Humor**: Puns and wordplay rarely translate directly
-5. **Implied Subjects**: "Hope to see you" - subject "I" implied
-6. **Conditional Structures**: Complex if-then constructions need careful handling
-
-### Style Considerations
-
-**American vs. British English**:
-
-- Spelling: color/colour, organize/organise, center/centre
-- Vocabulary: elevator/lift, truck/lorry, apartment/flat
-- Date format: 12/25/2023 (US) vs. 25/12/2023 (UK)
-- Punctuation: Quotation mark placement differs
-
-**Technical Writing**:
-
-- Prefer active voice for clarity
-- Use parallel structure in lists
-- Avoid ambiguous pronouns
-- Define acronyms on first use
-- Use consistent terminology
-
-**Creative Writing**:
-
-- Greater flexibility with grammar
-- Sentence fragments acceptable for effect
-- Metaphors and figurative language
-- Varied sentence rhythm
-- Descriptive vocabulary
-
-### Common English Idioms for Translation
-
-**Achievement/Success**:
-
-- Hit a home run (great success)
-- Knock it out of the park (huge success)
-- Ace the test (do very well)
-- Piece of cake (very easy)
-- A slam dunk (sure success)
-
-**Difficulty/Problems**:
-
-- Hit a snag (encounter a problem)
-- An uphill battle (difficult task)
-- Back to square one (start over)
-- Bite off more than you can chew (take on too much)
-
-**Communication**:
-
-- Get the ball rolling (start something)
-- Beat around the bush (avoid the main point)
-- Cut to the chase (get to the point)
-- On the same page (in agreement)
-- Touch base (make contact)
-
-**Time**:
-
-- In the nick of time (just in time)
-- Better late than never
-- Time flies (time passes quickly)
-- Once in a blue moon (very rarely)
-
-**Understanding**:
-
-- Hit the nail on the head (exactly right)
-- Get the picture (understand)
-- Ring a bell (sound familiar)
-- Connect the dots (see the relationship)
-
-## Vocabulary Notes
-
-### Modal Verbs and Nuance
-
-- **Can**: Ability or possibility
-- **Could**: Past ability, polite request, possibility
-- **May**: Permission (formal), possibility
-- **Might**: Lower probability than "may"
-- **Must**: Strong obligation, logical necessity
-- **Should**: Recommendation, expectation
-- **Would**: Conditional, polite request, habitual past
-- **Will**: Future, determination, prediction
-
-### Phrasal Verbs (Common Examples)
-
-- **Pick up**: Lift, collect, learn, improve
-- **Put off**: Postpone, discourage
-- **Get over**: Recover from, overcome
-- **Look into**: Investigate
-- **Come across**: Find by chance, seem
-- **Turn down**: Reject, reduce volume
-- **Figure out**: Solve, understand
-- **Bring up**: Mention, raise (a topic)
-
-### Register Pairs (Informal → Formal)
-
-- buy → purchase
-- help → assist
-- use → utilize
-- get → obtain/acquire
-- ask → inquire
-- show → demonstrate
-- tell → inform
-- begin → commence
-- end → terminate/conclude
-- need → require
-
-## Regional Variations
-
-### American English
-
-- More direct communication style
-- Simplified spelling (color, organize)
-- Different vocabulary (apartment, elevator, sidewalk)
-- Measurement: imperial system (feet, miles, Fahrenheit)
-
-### British English
-
-- More formal/indirect communication style
-- Traditional spelling (colour, organise)
-- Different vocabulary (flat, lift, pavement)
-- Measurement: mix of metric and imperial
-
-### Other English Varieties
-
-- **Canadian**: Mix of American and British conventions
-- **Australian**: British spelling, unique slang
-- **Indian**: British influence with local expressions
-- **Singapore**: Simplified, influenced by Chinese grammar patterns
-
-## Translation Best Practices
-
-1. **Maintain Tone**: Match formality level of source text
-2. **Cultural Adaptation**: Adapt idioms and references for understanding
-3. **Clarity Over Literalness**: Prioritize clear meaning
-4. **Natural Phrasing**: Should sound natural to native speakers
-5. **Consistent Terminology**: Use same terms for same concepts
-6. **Verify Idioms**: Don't translate idioms word-for-word
-7. **Check Register**: Formal/informal should match source
-8. **Read Aloud**: Natural translations sound good when spoken
-9. **Consider Audience**: US vs. UK vs. international English
-10. **Proofread Carefully**: English has many irregular spellings and homonyms