Project manager by Martin Reddy

 

 

 

(19:25:23)*MartinReddy与所有人说:but do not expose any of the internal private details 

(19:25:41)*MartinReddy与所有人说:That's essentially what a facade tries to do: 

(19:25:51)*MartinReddy与所有人说:wraps a new interface around some existing code 

(19:27:39)*十一月的雨与所有人说:ok, good 

(19:29:31)umlchina与*MartinReddy说:Qeustion from Zhang Chunping: Any design patterns on API design besides 23 GOF patterns? 

(19:31:12)*MartinReddy与所有人说:That's a good question 

(19:31:42)*MartinReddy与所有人说:Some of the GOF patterns can be applied more to your implementation, rather than your interface 

(19:32:08)*MartinReddy与所有人说:For example, a Facade or Proxy is clearly providing an API: a public interface 

(19:32:27)*MartinReddy与所有人说:But perhaps you might want to hide your use of Singleton as an implementation detail 

(19:32:39)*MartinReddy与所有人说:So some GOF patterns are more applicable to API Design that others 

(19:32:56)*MartinReddy与所有人说:Also there are other patterns or idioms that can be applied to API Design 

(19:33:05)*MartinReddy与所有人说:For example, the Pimpl Idiom in C++ 

(19:33:45)*MartinReddy与所有人说:Or Named Parameter Idom (NPI) as an alternative to functions with lots of parameters 

(19:34:45)[*十一月的雨]与所有人说:great 

(19:34:54)lidachun与所有人说:C++ 设计的API接口能否适用于其他语言，这样的设计更有通用性 

(19:34:58)umlchina与*MartinReddy说:Tian Shengjun's question: Which type of class is better on api design, pure vitual class or entity c 

(19:35:09)umlchina与*MartinReddy说:pure vitual class or entity class(what he mean may be concrete class) ? 

(19:35:37)*MartinReddy与所有人说:Well, I think it depends on what you are trying to design 

(19:36:01)*MartinReddy与所有人说:For example, you will use a pure virtual function to create an "interface" 

(19:36:16)*MartinReddy与所有人说:(as in the Java sense of interface) 

(19:36:56)*MartinReddy与所有人说:I often advocate avoiding using virtual until you know you want users to inherit 

(19:37:14)*MartinReddy与所有人说:Because creating a virtual exposes a lot more of your class's internal details 

(19:37:38)*MartinReddy与所有人说:There is a tension here between creating a design that is very extensible by your users 

(19:37:53)*MartinReddy与所有人说:But also exposes too much internal details 

(19:38:19)*MartinReddy与所有人说:I don't think there's a hard and fast rule, but I prefer to avoid exposing internal details until 

(19:38:26)*MartinReddy与所有人说:absolutely necessary 

(19:39:16)*MartinReddy与所有人说:(How about I write "END" when I'm done with my answers so you know when I'm done?) 

(19:39:18)*MartinReddy与所有人说:END 

(19:40:04)umlchina与*MartinReddy说:Thank you 

(19:40:27)[*十一月的雨]与所有人说:thanks for your great ansowers 

(19:40:37)*MartinReddy与所有人说:You're welcome! 

(19:41:26)*MartinReddy与所有人说:There were some questions earlier about what an API is. Perhaps I could quickly address that 

(19:41:53)*MartinReddy与所有人说:I see an API is simply: code that other users (or programs) have to use 

(19:42:21)*MartinReddy与所有人说:An API is the abstract description of the interface: 

(19:42:28)umlchina与*MartinReddy说:Li Wenjun's question: how can I get good interface, from use case specification (top to bottom) or f 

(19:42:34)*MartinReddy与所有人说:i.e., the function calls, enums, types, consts etc. 

(19:42:42)umlchina与*MartinReddy说:(top to bottom) or from existing classes (bottom to top)? 

(19:43:01)*MartinReddy与所有人说:And these can by implemented in a library that you link into your programs 

(19:44:14)*MartinReddy与所有人说:Li Wenjun: my own preference is to gather requirements from the users 

(19:44:37)*MartinReddy与所有人说:and then to try to extract the key concepts - the major classes - from that information 

(19:44:54)*MartinReddy与所有人说:then to work out how these major classes relate to each other 

(19:45:19)*MartinReddy与所有人说:So, my preference, is to try and work out the coarse, high-level architecture first 

(19:45:48)*MartinReddy与所有人说:from there you can dive down to specific classes 

(19:46:11)*MartinReddy与所有人说:but only to the level that you want to - i.e., you don't have to design every class 

(19:46:42)*MartinReddy与所有人说:I then prefer to add more detail in an interative (agile) approach 

(19:47:00)*MartinReddy与所有人说:but I think it's important for everyone on a team to have a shared high-level architecture 

(19:47:11)*MartinReddy与所有人说:in their heads before starting on an agile iteration 

 

(19:49:38)umlchina与*MartinReddy说:Ouyang Jiexiao's question: I am interested in your experience in Pixar and Linden Lab, How were you 

(19:49:51)umlchina与*MartinReddy说:Linden Lab, How were you feeling there? How are the development process in them? 

(19:50:02)umlchina与[*十一月的雨]说:会的 

(19:50:25)*MartinReddy与所有人说:Ouyang Jiexiao: Yes, great question. Every company I have worked in has been very different.

(19:50:44)*MartinReddy与所有人说:At Pixar, we had a very large code base that was over 25 years old 

(19:51:13)*MartinReddy与所有人说:The code had devolved somewhat, so that it was difficult to make major changes 

(19:51:35)*MartinReddy与所有人说:We therefore decided to build a new film-making system to replace the old one 

(19:52:03)*MartinReddy与所有人说:To do this, we tried to adopt good software development processes 

(19:52:27)*MartinReddy与所有人说:We had a design team (called Object Modeling) who was responsible for creating the architecture 

(19:52:44)*MartinReddy与所有人说:and class designs, and communicating those to everyone 

(19:53:07)*MartinReddy与所有人说:We had a large QA team because we placed a big focus on writing automated tests 

(19:53:28)*MartinReddy与所有人说:We required all core (non-GUI) code to have 100% line coverage by unit tests 

(19:53:53)*MartinReddy与所有人说:We also had a UI design team and documentation team to provide good user experience 

(19:54:21)*MartinReddy与所有人说:In terms of engineering, we adopted some agile techniques, but we were still quite heavy processwise 

(19:54:37)*MartinReddy与所有人说:For example, we developed a lot of requirements documents 

(19:54:57)*MartinReddy与所有人说:In contrast, at Linden Lab, the team embraced agile a lot 

(19:55:08)*MartinReddy与所有人说:At Linden, we used SCRUM 

(19:55:39)*MartinReddy与所有人说:So we would collect user stories, define our backlog, prioritize and bid out our iterations 

(19:55:55)*MartinReddy与所有人说:and try to stick to 2-week iterations (at Pixar, it was more like 2 months) 

(19:56:24)*MartinReddy与所有人说:I learned to like SCRUM a lot - although there are things you have to be aware of when using SCRUM 

(19:57:02)*MartinReddy与所有人说:I'm happy to chat more about any of those development techniques/processes if you like 

(19:57:13)*MartinReddy与所有人说:END 

*╆佳娱★神马说：●本期庄家【*放羊的狼】【★⑩把【游戏】:★10万━100万（远端）】:线上、线下、悄悄吃掉●不开语音者后果自负●记录【】

*╆佳娱★神马说：●本期庄家【*放羊的狼】【★⑩把【游戏】:★10万━100万（远端）】:线上、线下、悄悄吃掉●不开语音者后果自负●记录【】

*╆佳娱★神马说：●本期庄家【*放羊的狼】【★⑩把【游戏】:★10万━100万（远端）】:线上、线下、悄悄吃掉●不开语音者后果自负●记录【】

(19:58:11)umlchina与*MartinReddy说:Liu Minye's question: In our company, all developers are busy on their own project, no one would do 

系统： Яεхㄒε所在的IP被管理员umlchina屏蔽了。

(19:58:41)umlchina与*MartinReddy说:no one would do more work on better API or other reusable things. How to change such situation 

(19:59:04)*MartinReddy与所有人说:Liu Minye: I see this a lot 

(19:59:32)*MartinReddy与所有人说:For example, when Linden Lab was a small company developers were told 

(19:59:39)*MartinReddy与所有人说:to "do what you want" 

(19:59:54)*MartinReddy与所有人说:this can be a good thing when you have a small team of talented engineers 

(20:00:04)*MartinReddy与所有人说:you are basically saying that you trust them to make good decisions 

(20:00:17)*MartinReddy与所有人说:However, over time, this can turn out to be a bad thing 

(20:00:34)*MartinReddy与所有人说:For example, the Second Life client eventually became very difficult to use 

(20:00:49)*MartinReddy与所有人说:with lots of options and features, some options that conflicted with each other, 

(20:01:06)*MartinReddy与所有人说:We reached the point where we had to step back and look at the produt as a whole 

(20:01:20)*MartinReddy与所有人说:and come up with a unified vision for how it was supposed to work 

(20:01:36)*MartinReddy与所有人说:To remove features that didn't make sense or combine similar features 

(20:01:54)*MartinReddy与所有人说:Unfortunately, many companies only adapt after they realize that things have gotten very bad 

(20:02:16)*MartinReddy与所有人说:It can be difficult to realize ahead of time and make changes to avoid these problems 

(20:02:27)*MartinReddy与所有人说:One big thing for me is communication 

(20:02:49)*MartinReddy与所有人说:When a team is very small, you can just talk to the person sitting next to you 

(20:03:01)*MartinReddy与所有人说:But when a team grows, the communication channels have to evolve too 

(20:03:22)*MartinReddy与所有人说:This might mean more documentation or more meetings or more e-mail 

(20:03:36)*MartinReddy与所有人说:None of which is very fun, but if you don't fix your communication channels 

(20:03:56)*MartinReddy与所有人说:then developers don't know what everyone else is doing and you get into problems 

(20:04:02)*MartinReddy与所有人说:So, to answer your question: 

(20:04:28)*MartinReddy与所有人说:The management has to agree that developers should work to a unified vision 

(20:04:43)*MartinReddy与所有人说:And the communication channels have to allow developers to know what else is going on 

(20:04:59)*MartinReddy与所有人说:As an example, at Pixar, we held "Weeklies" 

(20:05:18)*MartinReddy与所有人说:which was a meeting where the entire team (dev, QA, design, doc, etc.) go together 

(20:05:28)*MartinReddy与所有人说:and engineers would demonstrate things they had been working on 

(20:05:44)*MartinReddy与所有人说:this was a great way to communicate new changes and often caused people to start 

(20:05:56)*MartinReddy与所有人说:talking to each other because they realized they could help each other 

(20:05:58)*MartinReddy与所有人说:END 

(20:06:23)*MartinReddy与所有人说:Actually, I'll say a little more... :-) 

(20:06:35)*MartinReddy与所有人说:Your question was really more about taking the time to write good APIs 

(20:06:44)*MartinReddy与所有人说:I don't think I answered that very well 

(20:06:59)*MartinReddy与所有人说:But it's a similar issue, that companies don't see the value of good API design 

(20:07:23)*MartinReddy与所有人说:until there code has devolved and become unusable, at which point it's too late 

(20:07:45)*MartinReddy与所有人说:It really takes someone with experience to be able to convince management that you actually 

(20:08:02)*MartinReddy与所有人说:save time in the long term by spending more time writing good APIs up front 

(20:08:20)*MartinReddy与所有人说:because the maintenance costs should be reduced over time 

(20:08:39)*MartinReddy与所有人说:Hopefully that's a better answer to your question Liu Minye 

(20:08:40)*MartinReddy与所有人说:END 

(20:11:20)*MartinReddy与所有人说:That's okay :-) 

(20:11:27)*MartinReddy与所有人说:I'm happy to be here 

(20:11:38)*MartinReddy与所有人说:Have a good evening! 

(20:12:17)*MartinReddy与所有人说:Me too :-) 

19:47:17)*MartinReddy与所有人说:END