feat: list of various doc updates

[NoNameProvided]

Description

This issue describes a list of various updates to the documentation.

General

• [ ] explain that injection only happens when class created via Container.get
• [ ] explain cyclic dependency injection only works with property injection
• [ ] add example for mocking classes with TypeDI
  • example: Container.set({ id: MyRealClass, type: MyMockedClass })
  • example: Container.set({ id: MyRealClass, value: { doStuff: () => console.log('mocked') }})
• [ ] explain difference between setting values with type and value
• [ ] explain how custom factories work (class and function factories
  • eg: @Service({ factory: [CarFactory, 'create'] })
  • eg: @Service({ factory: carFactory })
• [ ] explain multiple: true when registering services
• [ ] explain how services are overwritten when re-registered
  • this needs extra implementation: allow throwing error when service already exists
• [ ] explain container inheritance
  • this needs implementation, current behaviour will change
• [ ] add documentation for configuration with Babel (to retain type metadata emitted by Typescript)

@Service decorator

• [ ] add documentation for named services (eg: @Service('scopeA.myservice'))
  • can be injected with the same name only (eg: @Inject('scopeA.myservice'))

@Inject decorator

• [ ] explaining that only constructable types are auto-inferred (eg: you must provide ID for a string value