Attachments and Formatting

Attachments and Formatting

A task has two related but different tools: attachments as separate task files, and formatted text inside descriptions or comments. Attachments are best for documents and artifacts; formatting is best for readable instructions, code, and technical snippets.

1. Task attachments

Attachments are added from the create or edit form. They appear as a separate block in the task details screen: filename, type, and size are visible before download. iTasks supports working formats up to 20 MB: PDF, DOCX, XLSX, PPTX, ZIP, images, audio, and video.

2. Removing and replacing files

Edit mode gives each attachment a remove action. To replace a file, remove the old one and attach the new version. This keeps the task clean and avoids making teammates guess which document is current.

3. Description formatting

The task description supports headings, lists, bold text, inline code, quotes, images, and code blocks. For technical tasks, use code blocks for commands, configuration, and short logs: they are easier to read than long plain-text lines.

4. Comment formatting

Comments support compact formatting: inline code, code blocks, bold and italic text, plus task mentions through @. Discussion and quoted replies are covered in Comments, Replies, and Mentions.

File practice

Keep only artifacts needed for the next action in the task: checklist, telemetry, bench log, error screenshot, specification, or build archive. Large general materials are usually better linked from the description so the task does not become an unstructured file store.