README files are one way of documenting a development project. READMEs play an especially important role in open-source software, as they give the reader valuable information about the code you created.

README files are one way of documenting a development project. READMEs play an especially important role in open-source software, as they give the reader valuable information about the code you created. There is no standard README format. Much of the format depends on the scope of the software or project, so it’s really up to the developer what information should be included or provided. However, there are several elements that are part of good README files:

• A description of the purpose of the project
• A demonstration of how it works (its functional operations)
• An identification of the tools used and a rationale for why those tools were chosen
• An explanation of how to reproduce the project

In this assignment, you will explore and implement best practices for creating README files. This will help prepare you for the README files that you will need to create in Projects One and Two.

Prompt

This assignment provides you with some sample README files to explore and a README template. After you have reviewed the required documentation for creating a README file, you will learn about and implement best practices for creating your own README files.

1. Explore the following example README files: Zircon, BigFoot Dash App, and Plotly Dash. These READMEs come from a variety of different software projects and have different strengths and weaknesses. As you read, consider the following:
   • How clearly did each README file describe the purpose of their project?
   • What information did the README files include about the functionality of their project? What was helpful about this information? What could be improved?
   • What information did the README files include about the tools (software and libraries) that they used or how the user could reproduce the project?

   Note: You do not need to submit anything related to this step. These are examples to guide your work in the next step.

1. After exploring the sample README files, begin creating your own README file for the CRUD Python module that you began creating in the Module Four milestone. Use the README template Word Document to get started. You must address each of the following:
   • Describe the purpose of the project by completing the About the Project and Motivation sections of the template.
   • Demonstrate the project’s functional operations by completing the Usage section. Be sure to include examples of your code and screenshots that show how your module works.
   • Document the tools used, identifying each tool and including your rationale for using these tools, by completing the Installation section. “Tools” include any software applications as well as any libraries used to complete your work.
   • Create instructions for reproducing the project by completing the Getting Started section. Discuss what the user of this CRUD Python module would need to do to get started. Some points to address are:
     • Briefly describe the database and user authentication that you set up in the Module Three milestone.
     • Briefly describe how you created the C and R portions of your Python module, any challenges you encountered, and how you overcame them.

     Note: In this assignment, you only need to focus on creating a README for the create and read functionality of your CRUD Python module. You will continue developing the update and delete functionality as a part of Project One, which is due in Module Five. You will also need to update your README file for that assignment.

Guidelines for Submission

Your completed README file should be a 1– to 2–page Word document with double spacing, 11-point Calibri font, and one-inch margins. Use the provided README template to meet the expectations for this assignment.

Collepals.com Plagiarism Free Papers

Are you looking for custom essay writing service or even dissertation writing services? Just request for our write my paper service, and we'll match you with the best essay writer in your subject! With an exceptional team of professional academic experts in a wide range of subjects, we can guarantee you an unrivaled quality of custom-written papers.

Get ZERO PLAGIARISM, HUMAN WRITTEN ESSAYS

Why Hire Collepals.com writers to do your paper?

Quality- We are experienced and have access to ample research materials.

We write plagiarism Free Content

Confidential- We never share or sell your personal information to third parties.

Support-Chat with us today! We are always waiting to answer all your questions.