ORCID Advocacy Toolkit/About this book/Authoring Guide/

Authoring Guide Content Style and Format When creating content for the ORCID Advocacy Toolkit: Be concise: Focus on practical information that helps users take action. Use clear structure: Include headings, subheadings, and bullet points for easy scanning. Consider context: Explain why your approach works, not just what to do. Format consistently: Use Wikimedia markup for headings (== for main headings, === for subheadings) Keep paragraphs short (3-4 sentences maximum) Use bullet points for lists Include links to external resources where appropriate Content Types The toolkit welcomes various contribution types: How-to guides: Step-by-step instructions for specific advocacy activities Templates: Customizable communications, presentations, or workshop plans Case studies: Real-world examples of successful ORCID implementation and advocacy Resource collections: Curated lists of useful tools, articles, or resources Checklists: Quick reference guides for planning and implementing advocacy efforts Writing Recommendations Start with a clear purpose statement: What problem does your contribution solve? Include context: Brief background on when and why to use your approach Provide concrete examples: Show real applications where possible Consider adaptability: Note how content might be modified for different contexts Credit sources: Acknowledge inspirations and reference external resources Include contact details: Add your name and institution to the contributors list (optional but encouraged)