Skip to content

Create EFFDE.md#59

Open
SoTi-AF wants to merge 6 commits intoairframesio:mainfrom
SoTi-AF:patch-11
Open

Create EFFDE.md#59
SoTi-AF wants to merge 6 commits intoairframesio:mainfrom
SoTi-AF:patch-11

Conversation

@SoTi-AF
Copy link
Contributor

@SoTi-AF SoTi-AF commented Feb 28, 2026

Contains Existing Fault Flight Deck Effects Maintenance Reports

Summary by CodeRabbit

  • Documentation
    • Added a "Message Format" section describing labeled message fields (Message, FDE, MSG, DB, NCMM, EOR) and an "Analysis" section defining abbreviations and component roles (e.g., FDE, ATA chapter, NCMM, MSG, DB, A/L, EOR). This is documentation-only and introduces no functional or user-facing behavior changes.

Contains Existing Fault Flight Deck Effects Maintenance Reports
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 28, 2026

Warning

Rate limit exceeded

@SoTi-AF has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 23 minutes and 19 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📥 Commits

Reviewing files that changed from the base of the PR and between 9c69b2f and 3867ec4.

📒 Files selected for processing (1)
  • research/H1/EFFDE.md
📝 Walkthrough

Walkthrough

Added a "Message Format" section to research/H1/EFFDE.md listing labeled lines (Message, FDE, MSG, DB, NCMM, EOR) and an "Analysis" block defining abbreviations and terms; no code, exports, or runtime logic changed.

Changes

Cohort / File(s) Summary
Documentation
research/H1/EFFDE.md
Inserted a "Message Format" block with labeled entries (Message, FDE, MSG, DB, NCMM, EOR) and an "Analysis" section defining abbreviations/terms (EFFDE, FDE, ATA chapter, NCMM, MSG, DB, A/L, EOR). No functional changes.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Suggested reviewers

  • makrsmark

Poem

I hop through lines where messages play,
FDE and MSG in tidy array.
DB hums low and NCMM sings,
EOR blinks at little things—
A rabbit cheers the docs today. 🐇

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'Create EFFDE.md' accurately describes the primary change in the pull request, which is the creation of a new documentation file for EFFDE (Existing Fault Flight Deck Effects) maintenance reports.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@research/H1/EFFDE.md`:
- Line 1: The file research/H1/EFFDE.md is empty but the PR requires "Existing
Fault Flight Deck Effects Maintenance Reports"; populate EFFDE.md with the full
maintenance report content: include a clear title "Existing Fault Flight Deck
Effects (EFFDE) Maintenance Reports", a summary/introduction, sections for
scope, observed faults, effects on flight deck systems, diagnostic data,
recommended corrective actions, references, and any appendices or data tables;
ensure the document uses the same headings/format conventions as other files in
research/H1 for consistency and save the completed content into EFFDE.md.

ℹ️ Review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 28331e2 and b857fb3.

📒 Files selected for processing (1)
  • research/H1/EFFDE.md

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@research/H1/EFFDE.md`:
- Around line 1-18: Add a document title "Existing Fault Flight Deck Effects
(EFFDE) Maintenance Reports", a short introduction explaining what EFFDE/FDE
maintenance messages are and their purpose, and a glossary defining the acronyms
used in the file (EFFDE, FDE, MSG, DB, NCMM, A, EOR). Also add a "Message
Format" section that documents the header line fields (e.g., message type,
date/time, aircraft ID, route/airports, affected components/ids) and explain the
meaning of example entries like "MSG 2124400 L" and the DB lines ("DB
<component> (<location>)"), so the content under the existing "Message Format"
block is self-explanatory.

ℹ️ Review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between b857fb3 and da32bdd.

📒 Files selected for processing (1)
  • research/H1/EFFDE.md

Comment on lines +1 to +18
Message Format

EFFDE 1 27FEB26 1031 AIVT-ALP AIC186D CYVR/LOWW 311B-BCG-00W-19 L
FDE 21200100 A
MSG 2124400 L
DB CABIN TEMPERATURE CONTROLLER (R CHAN2)
DB CABIN TEMPERATURE CONTROLLER (R CHAN1)
NCMM
MSG 4517100 A
DB CENTRAL MAINTENANCE COMPUTING FUNCTION
MSG 3140202 A
DB ACMF IN RIGHT AIMS
MSG 2359905 A
DB HF COMMUNICATION TRANSCEIVER (RIGHT)
EOR



Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🛠️ Refactor suggestion | 🟠 Major

Add document title, introduction, and acronym definitions.

The file now contains message format content (resolving the previous empty-file issue), but it lacks essential documentation structure to make it self-explanatory:

  • Missing document title: Add a clear heading like "# Existing Fault Flight Deck Effects (EFFDE) Maintenance Reports"
  • Missing introduction: Explain what EFFDE reports are and their purpose
  • Missing acronym definitions: Include the definitions you provided in PR comments (EFFDE, FDE, MSG, DB, NCMM, A, EOR) as a glossary or legend section
  • Missing format explanation: Document what each field in the header line represents (date, aircraft ID, route, etc.)

Readers should be able to understand this documentation without referring to PR comments or external sources.

📝 Suggested documentation structure
+# Existing Fault Flight Deck Effects (EFFDE) Maintenance Reports
+
+## Overview
+
+EFFDE reports document existing faults and their effects on flight deck systems. These reports are generated to track active faults and maintenance messages for flight crew attention and maintenance action.
+
+## Acronym Definitions
+
+- **EFFDE**: Existing Fault Flight Deck Effect Report
+- **FDE**: Flight Deck Effect (STATUS message displayed on EICAS for flight crew attention)
+- **MSG**: Message
+- **DB**: Detected By (Source System that detected the fault)
+- **NCMM**: Non-Correlated Maintenance Message (part of report with no STATUS related messages)
+- **A**: Active Fault
+- **L**: [Add definition]
+- **EOR**: End Of Report
+
+## Message Format
+
+### Header Line Format
+
+`EFFDE [number] [date] [time] [aircraft-registration] [flight-number] [route] [aircraft-type] [status]`
+
+### Example Report
+
 Message Format
 
 EFFDE 1 27FEB26 1031 AIVT-ALP AIC186D CYVR/LOWW 311B-BCG-00W-19 L
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@research/H1/EFFDE.md` around lines 1 - 18, Add a document title "Existing
Fault Flight Deck Effects (EFFDE) Maintenance Reports", a short introduction
explaining what EFFDE/FDE maintenance messages are and their purpose, and a
glossary defining the acronyms used in the file (EFFDE, FDE, MSG, DB, NCMM, A,
EOR). Also add a "Message Format" section that documents the header line fields
(e.g., message type, date/time, aircraft ID, route/airports, affected
components/ids) and explain the meaning of example entries like "MSG 2124400 L"
and the DB lines ("DB <component> (<location>)"), so the content under the
existing "Message Format" block is self-explanatory.

Added analysis section with definitions and acronyms related to flight deck effect reports.
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

♻️ Duplicate comments (1)
research/H1/EFFDE.md (1)

1-34: 🛠️ Refactor suggestion | 🟠 Major

Add document title and introduction section.

While the new "Analysis" section with definitions is a good addition, the document still lacks fundamental structure:

  • Missing document title: The file should start with a top-level heading like # Existing Fault Flight Deck Effects (EFFDE) Maintenance Reports
  • Missing introduction: Add a brief overview explaining what EFFDE reports are, their purpose, and when they are generated

These structural elements are essential for making the documentation self-contained and understandable without external context.

📄 Suggested document structure
+# Existing Fault Flight Deck Effects (EFFDE) Maintenance Reports
+
+## Overview
+
+EFFDE reports document existing faults and their effects on flight deck systems. These maintenance reports track active and latched faults, along with associated status messages displayed to the flight crew.
+
 Message Format
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@research/H1/EFFDE.md` around lines 1 - 34, Add a top-level title and a short
introduction at the top of the document before the existing "Analysis" section:
insert a heading such as "Existing Fault Flight Deck Effects (EFFDE) Maintenance
Reports" and a 2–3 sentence intro that defines EFFDE reports, their purpose (to
notify flightcrew of maintenance-detected failures via EICAS/status messages),
and when they are generated (e.g., upon detection of CMC, ACMF, HF transceiver
faults or other onboard maintenance messages). Keep the existing "Analysis"
section and definitions (311B-BCG-00W-19, FDE, NCMM, etc.) unchanged and
immediately follow the new introduction with that section.
🧹 Nitpick comments (3)
research/H1/EFFDE.md (3)

26-26: Minor grammar improvement: hyphenate compound adjective.

The phrase "STATUS related messages" should be hyphenated as "STATUS-related messages" when used as a compound adjective modifying a noun.

-NCMM = Non-Correlated Maintenance Message part of Report (with no STATUS related messages)
+NCMM = Non-Correlated Maintenance Message part of Report (with no STATUS-related messages)
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@research/H1/EFFDE.md` at line 26, Update the phrase in the NCMM definition to
hyphenate the compound adjective: change "STATUS related messages" to
"STATUS-related messages" in the NCMM = Non-Correlated Maintenance Message part
of Report (with no STATUS related messages) line so the compound adjective is
grammatically correct.

1-15: Document the header line format and field meanings.

The message format example is provided, but the structure of the header line (line 3) is not explained. Readers cannot interpret what each field represents without additional context.

Consider adding a subsection that explains the format:

## Message Format

### Header Line Structure

`EFFDE [sequence] [date] [time] [aircraft-reg] [flight-num] [route] [part-number] [source]`

**Example:**

This would make the documentation more complete and easier to understand.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@research/H1/EFFDE.md` around lines 1 - 15, Add a new subsection under
"Message Format" that documents the header line structure for the example header
"EFFDE 1 27FEB26 1031 AIVT-ALP AIC186D CYVR/LOWW 311B-BCG-00W-19 L": list and
define each field in order (e.g. record type, sequence number, date, time,
aircraft registration, flight/MSG identifier, route/origin-destination,
part/issue number, source/priority flag), provide the suggested header template
string `EFFDE [sequence] [date] [time] [aircraft-reg] [flight-id] [route]
[part-number] [source]` and include a short annotated example mapping each token
from the header line to its explained field so readers can interpret the message
format unambiguously.

17-30: Consider reorganizing definitions before the message format example.

The "Analysis" section provides helpful definitions, but placing them after the example message means readers must scroll down to understand the format. Consider restructuring as:

  1. Title and overview
  2. Acronym definitions (current Analysis content)
  3. Message format example

This would improve readability by providing context before the example.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@research/H1/EFFDE.md` around lines 17 - 30, Reorder the document so the
"Analysis" definitions (entries like EFFDE, FDE, CMC, NCMM, MSG, DB, A or L, EOR
and the CMC Part Number/L mapping) appear immediately after the title/overview
and before the message format example; update the headings so the flow is: Title
and overview, Acronym/term definitions (the current Analysis block), then the
Message format example, ensuring references to "Analysis" and terms such as
EFFDE/FDE/CMC are preserved exactly.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Duplicate comments:
In `@research/H1/EFFDE.md`:
- Around line 1-34: Add a top-level title and a short introduction at the top of
the document before the existing "Analysis" section: insert a heading such as
"Existing Fault Flight Deck Effects (EFFDE) Maintenance Reports" and a 2–3
sentence intro that defines EFFDE reports, their purpose (to notify flightcrew
of maintenance-detected failures via EICAS/status messages), and when they are
generated (e.g., upon detection of CMC, ACMF, HF transceiver faults or other
onboard maintenance messages). Keep the existing "Analysis" section and
definitions (311B-BCG-00W-19, FDE, NCMM, etc.) unchanged and immediately follow
the new introduction with that section.

---

Nitpick comments:
In `@research/H1/EFFDE.md`:
- Line 26: Update the phrase in the NCMM definition to hyphenate the compound
adjective: change "STATUS related messages" to "STATUS-related messages" in the
NCMM = Non-Correlated Maintenance Message part of Report (with no STATUS related
messages) line so the compound adjective is grammatically correct.
- Around line 1-15: Add a new subsection under "Message Format" that documents
the header line structure for the example header "EFFDE 1 27FEB26 1031 AIVT-ALP
AIC186D CYVR/LOWW 311B-BCG-00W-19 L": list and define each field in order (e.g.
record type, sequence number, date, time, aircraft registration, flight/MSG
identifier, route/origin-destination, part/issue number, source/priority flag),
provide the suggested header template string `EFFDE [sequence] [date] [time]
[aircraft-reg] [flight-id] [route] [part-number] [source]` and include a short
annotated example mapping each token from the header line to its explained field
so readers can interpret the message format unambiguously.
- Around line 17-30: Reorder the document so the "Analysis" definitions (entries
like EFFDE, FDE, CMC, NCMM, MSG, DB, A or L, EOR and the CMC Part Number/L
mapping) appear immediately after the title/overview and before the message
format example; update the headings so the flow is: Title and overview,
Acronym/term definitions (the current Analysis block), then the Message format
example, ensuring references to "Analysis" and terms such as EFFDE/FDE/CMC are
preserved exactly.

ℹ️ Review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between da32bdd and c31f8c2.

📒 Files selected for processing (1)
  • research/H1/EFFDE.md

Added detailed description and examples for EFFDE.
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

♻️ Duplicate comments (1)
research/H1/EFFDE.md (1)

1-7: ⚠️ Potential issue | 🟠 Major

Add a proper document title using Markdown heading syntax.

The file still lacks a top-level # heading. A previous review specifically requested adding a document title like "# Existing Fault Flight Deck Effects (EFFDE) Maintenance Reports". Without this, the document lacks proper structure and won't render correctly in documentation systems or table of contents.

📝 Suggested structure
+# Existing Fault Flight Deck Effects (EFFDE) Maintenance Reports
+
 Sublabel: EFFDE

-Description
+## Description

-Existing Fault Flight Deck Effect Report (BOEING)
-...
+EFFDE reports document existing faults and their effects on flight deck systems for Boeing aircraft. These reports are generated to track active faults and maintenance messages requiring flight crew attention and maintenance action.

-Examples
+## Examples

This addresses the outstanding feedback from the previous review and improves document organization.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@research/H1/EFFDE.md` around lines 1 - 7, Add a top-level Markdown heading to
the document by inserting a line at the very top: "# Existing Fault Flight Deck
Effects (EFFDE) Maintenance Reports" (or similar) so the file has a proper
document title; ensure this heading appears before "Sublabel: EFFDE" and the
"Description" section to allow correct rendering and inclusion in TOCs.
🧹 Nitpick comments (2)
research/H1/EFFDE.md (2)

1-2: Consider clarifying the "Sublabel" field.

The purpose of the "Sublabel" field is unclear. If this is project-specific metadata, consider adding a comment explaining its purpose or moving it to a YAML front matter block for better structure.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@research/H1/EFFDE.md` around lines 1 - 2, The "Sublabel: EFFDE" line is
ambiguous; either add an inline comment explaining what "Sublabel" means and how
"EFFDE" should be interpreted (e.g., tag, category, internal ID) or move this
metadata into a YAML front-matter block at the top of the document
(---\nSublabel: EFFDE\n---) so it’s structured and discoverable; update any
consumers or README that expect this metadata (search for the literal "Sublabel"
and "EFFDE" to find where to document or relocate it).

53-56: Remove excessive trailing blank lines.

The file ends with four consecutive blank lines. Consider reducing to a single trailing newline for cleaner formatting.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@research/H1/EFFDE.md` around lines 53 - 56, The file research/H1/EFFDE.md
currently ends with four consecutive blank lines; edit EFFDE.md to remove the
excess trailing blank lines so the file ends with a single newline (one trailing
newline character) to enforce clean formatting.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@research/H1/EFFDE.md`:
- Around line 3-7: Replace the placeholder ellipses in the "Description" section
with a concise introductory paragraph that defines EFFDE (Existing Fault Flight
Deck Effect) reports, explains that they document observed flight-deck anomalies
and fault effects tied to specific aircraft systems, states when/how they're
generated (e.g., after flight crew or on-ground diagnostics identify recurring
or safety-relevant faults and are filed via the maintenance reporting workflow),
identifies primary users (flight crew for initial reporting, maintenance
personnel and engineering for troubleshooting and corrective action, and
operations/quality for trend analysis), and clarifies the report’s role in the
maintenance reporting system as a record for immediate maintenance action,
root-cause investigation, and long-term reliability tracking.
- Around line 10-24: The fenced code block in research/H1/EFFDE.md (the block
starting with the EFFDE flight data lines such as "EFFDE 1 27FEB26 1031
AIVT-ALP..." and ending with "EOR") lacks a language identifier; update the
opening fence to include a language tag (for example add "text" after the
initial ```), e.g. change the opening "```" to "```text" so Markdown renderers
apply proper syntax highlighting.
- Around line 29-51: The fenced code block starting with "EFFDE = Existing Fault
Flight Deck Effect Report" needs a language identifier so it renders correctly;
update the opening triple backticks for that block to include an appropriate
specifier (e.g., add "text" so it becomes ```text) — locate the block containing
"EFFDE", "27FEB26", etc., and add the language token to the opening fence;
mirror the approach used in the Examples section for consistency.

---

Duplicate comments:
In `@research/H1/EFFDE.md`:
- Around line 1-7: Add a top-level Markdown heading to the document by inserting
a line at the very top: "# Existing Fault Flight Deck Effects (EFFDE)
Maintenance Reports" (or similar) so the file has a proper document title;
ensure this heading appears before "Sublabel: EFFDE" and the "Description"
section to allow correct rendering and inclusion in TOCs.

---

Nitpick comments:
In `@research/H1/EFFDE.md`:
- Around line 1-2: The "Sublabel: EFFDE" line is ambiguous; either add an inline
comment explaining what "Sublabel" means and how "EFFDE" should be interpreted
(e.g., tag, category, internal ID) or move this metadata into a YAML
front-matter block at the top of the document (---\nSublabel: EFFDE\n---) so
it’s structured and discoverable; update any consumers or README that expect
this metadata (search for the literal "Sublabel" and "EFFDE" to find where to
document or relocate it).
- Around line 53-56: The file research/H1/EFFDE.md currently ends with four
consecutive blank lines; edit EFFDE.md to remove the excess trailing blank lines
so the file ends with a single newline (one trailing newline character) to
enforce clean formatting.

ℹ️ Review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between c31f8c2 and 9c69b2f.

📒 Files selected for processing (1)
  • research/H1/EFFDE.md

Comment on lines +3 to +7
Description

Existing Fault Flight Deck Effect Report (BOEING)
...

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Complete the Description section with substantive content.

The Description section contains only the report name followed by placeholder ellipses ("..."). This leaves readers without essential context about what EFFDE reports are, their purpose, when they're generated, and how they're used in aircraft maintenance workflows.

Please replace the placeholder with a proper introduction explaining:

  • What EFFDE reports document and why they're important
  • When/how these reports are generated
  • Who uses them (flight crew, maintenance personnel, etc.)
  • Their role in the maintenance reporting system
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@research/H1/EFFDE.md` around lines 3 - 7, Replace the placeholder ellipses in
the "Description" section with a concise introductory paragraph that defines
EFFDE (Existing Fault Flight Deck Effect) reports, explains that they document
observed flight-deck anomalies and fault effects tied to specific aircraft
systems, states when/how they're generated (e.g., after flight crew or on-ground
diagnostics identify recurring or safety-relevant faults and are filed via the
maintenance reporting workflow), identifies primary users (flight crew for
initial reporting, maintenance personnel and engineering for troubleshooting and
corrective action, and operations/quality for trend analysis), and clarifies the
report’s role in the maintenance reporting system as a record for immediate
maintenance action, root-cause investigation, and long-term reliability
tracking.

SoTi-AF and others added 2 commits March 1, 2026 13:41
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant