Due Friday, 07 October 2022, 11:59:59pm
See Maze.Com, a Plan for our plan for the entire project, not just the first three
sprints. Being able to write such plans—
Delivery Place the product of this week’s milestone into your git repo as follows:
for the Programming Task, place board.PP into Maze/Common/, because both our referee and our players can use this “common” component.
Here .PP stands for a language-specific suffix, which depends on your choice of TAHBPL. Some languages demand a specific organization within the file system. In that case, you may place a link to the proper board.PP into Common/.
If your board representation calls for additional data representations that you would prefer to place into different files, place the files (and links) into Maze/Common.
for the Design Task, place state.md into Planning/ so that you can reflect on your planning ideas and failures at the end of the semester.
sliding a designated row or column in one or the other direction;
inserting a tile into the spot that is left open by a slide;
determining which tiles are reachable from a designated tile.
Design Task Only the referee knows everything about the game that enables it to grant turns, decide the validity of actions, and announce the end of the game and its outcome to every participant. This knowledge is called “game state.”
Design a data representation for the game state. List all pieces of functionality that should be available to the referee to run a game from start to completion.
To describe the data representation, mix English and references to the data sub-language of your chosen programming language. For the operations, choose the wish list format that you got to know in Fundamentals I and Fundamentals II, depending on which of the languages used in these courses matches your chosen language most closely. Distinguish the two parts clearly.
The memo should not exceed a page. Less is more.
Keep in mind our Maze.Com, a Plan while you work on a design task.
You do not need to read the rest of this page if you recall the notion of “design and implement” from Fundamentals I through III.
To design means to turn the information in the real world into a data
Design also means to think about what other components will want to know about
this information or perhaps represent a change over time. To this end, you are
to come up with a list of functionality—
Some information and functionality is explicit in the real world. Some is implicit. While the real board clearly consists of unique tiles and players can simply point at the tile where they wish to place an avatar, a data representation must make the grid and places on the grid explicit. What do you think is a good representation of “place”?
The referee is an example of implicit functionality. When a group of us sits around a kitchen table to play Maze, we collectively play referee. A software system cannot keep such functionality implicit; ideally, it must be open to audits in case of law suits.
To implement is to systematically turn the wish list of functionality into an implementation of functions and methods. Since this milestone it is about the design of a component, it also means to make some of these functions and methods public and keeping all helpers private. Use your chosen language well.
The entire point of proceeding systematically is to accommodate
change. It is unlikely that anyone’s first design and implementation of the
board is perfect. A good intuition will go a long way to finish most of the
needed work this week, but “easy change” is the name of the software
At Northeastern, we teach “systematic” from week 2 in the undergraduate curriculum. Follow these principles and you will be able to manage your time this semester