Summary
The pgfgantt package is causing milestones and markers to be moved forward a month in a Gantt chart. This issue is likely due to a misunderstanding of the package’s configuration options.
Root Cause
The root cause of this issue is the incorrect specification of the time slot unit and x unit in the ganttchart environment. The time slot unit is set to month, but the x unit is set to a fixed value of .9cm, which can cause the milestones and markers to be shifted forward in time.
Why This Happens in Real Systems
This issue can occur in real systems due to the following reasons:
- Incorrect configuration of the pgfgantt package
- Misunderstanding of the package’s options and their effects on the Gantt chart
- Insufficient testing and validation of the chart’s layout and timing
Real-World Impact
The impact of this issue can be significant, including:
- Inaccurate representation of project timelines and milestones
- Confusion and miscommunication among team members and stakeholders
- Difficulty in tracking progress and identifying delays
Example or Code
\documentclass[11pt]{article}
\usepackage{pgfgantt}
\begin{document}
\begin{ganttchart}[
expand chart=\textwidth,
x unit = 1cm,
y unit title=0.5cm,
y unit chart=0.7cm,
vgrid,
hgrid,
time slot format=isodate,
time slot unit=day,
milestone inline label node/.append style={right=2ex,fill=white,fill opacity=1,text opacity=1},
flip/.style={milestone inline label node/.append style={left=2ex}},
milestone/.append style={draw=none,fill=blue},
milestone label font=\normalfont,
]{2026-01-01}{2026-06-30}
\gantttitlecalendar{year,month=shortname}\\
\ganttmilestone[inline,flip]{milestone1}{2026-02-01}\\
\ganttmilestone[inline,flip]{milestone2}{2026-04-01}\\
\ganttvrule{marker}{2026-03-01}
\end{ganttchart}
\end{document}How Senior Engineers Fix It
Senior engineers can fix this issue by:
- Carefully reviewing the pgfgantt package documentation and options
- Adjusting the time slot unit and x unit to ensure accurate representation of the project timeline
- Testing and validating the chart’s layout and timing to ensure accuracy
Why Juniors Miss It
Junior engineers may miss this issue due to:
- Lack of experience with the pgfgantt package and its options
- Insufficient understanding of the package’s configuration and its effects on the Gantt chart
- Inadequate testing and validation of the chart’s layout and timing