Home/ Questions/Q 561881
In Process

The Archive Base Latest Questions

Editorial Team
  • 0
Asked: 2026-05-13T12:29:48+00:00

We outsourced a web based portal and now we’re not interested to work with

  • 0

We outsourced a web based portal and now we’re not interested to work with them because the site is becoming more buggy day by day and increase of customers complain.

We’ve chosen a different team based on their local reputation and their portfolio are good to satisfy our urgent needs. We discussed this project with them and during a week they suggested some good ideas which help us to control. We are agreed to award this project to them. What I am thinking during the transition:

What documents do you think which can help new developers to understand the application? How many kinds of document I can request to them? If a new developers start working on it those documents help them to understand easily of all sides (application, database, configuration etc)

The application is on ASP.NET and SQL SERVER 2005 and the scariest part of all no source control tool is there. They do direct deployments without even push the publish button. Touch Luck 🙁

Thanks.

Share

Leave an answer

You must login to add an answer.

Need An Account,

1 Answer

  1. Editorial Team

    That’s kind of hard to answer without knowing what kind of portal it is, but what comes to mind:

    • Owner’s manual: Description of functionality, technologies used, full overview of all machines and services involved (don’t forget data bases)

    • Backup: How and where is data backed up, where to restore it from in case of a crash

    • Description of all Databases used, relations between tables, at least quick rundown on what data is stored where

    • Links to any and all URLs to administration interfaces, tools, and scripts

    • Day-to-day operation: What cron jobs need to run frequently, are there caches, file lists or other things that need to be taken care of frequently

    • Make sure all domains used belong to you and are under your control

    • a description of the project’s file structure (which part is where; where is the API; where are the visual elements; where are the front controllers)

    • How-To’s on how to change the visual elements of the site (Style sheets, forms, templates…)

    • A description of any and all URL rewriting operations that take place in various parts of the systems, and where they point to

    • Which Google Analytics / Google Webmaster account is used and how to get hold of it

    • Ideally, an API documentation and full phpDoc style source code documentation

    • 0