Revised Documentation for Accuracy & Transitioned to USDOT fork of asn1c repository

[dmccoystephenson]

Revised Documentation for Accuracy

The documentation for the project has been reviewed and revised for accuracy. In some cases, improvements were made to formatting/organization to improve clarity.

Changes

README.md

• Fixed a typo ("Metatdata" instead of "Metadata")
• Adjusted headers to improve clarity
• Removed outdated 'Project Management' section in README
• Moved 'Confluent Cloud Integration' section to bottom of README

installation.md

• Adjusted headers & added table of contents to installation.md
• Moved 'Docker Installation' section to top of installation.md
• Heavily revised the docker/manual installation documentation in installation.md to ensure accuracy

interface.md

• Adjusted headers
• Fixed a typo (heirarchy instead of hierarchy)

configuration.md

• Fixed a typo
• Adjusted headers
• Revised ACM Testing with Kafka section

testing.md

• Reorganized document
• Added docker info

Transitioned to USDOT fork of asn1c repository

Problem

USDOT has recently created a fork of the mouse07410/asn1c project. To maintain internal references, the project needs to switch to using this new fork.

Solution

The project now uses https://github.com/usdot-fhwa-stol/usdot-asn1c as its ASN.1 Compiler. References to the submodule have been updated in the relevant scripts and Dockerfiles.

Testing

• Installing the asn1c tool has been verified to work
• Generating the J2735 implementation/header files has been verified to work for 2016 & 2020
• The docker image can be built successfully using the new 2020 generated files
• Unit tests are verified to be passing.

Note

It should be noted that using the latest commit in usdot-fhwa-stol/usdot-asn1c results in failure to compile the ACM. To work around this, the following commit is being referenced:
usdot-fhwa-stol/usdot-asn1c@e74487c